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INTRODUCTION 


This manual describes the features of the UNIX System. It provides neither a general overview of the UNIX System 
(for that, see “The UNIX Time-Sharing System,” BSTJ, Vol. 57, No. 6, Part 2, pp. 1905-29, by D. M. Ritchie and 
K. Thompson), nor details of the implementation of the system (see “UNIX Implementation,” BSTJ, same issue, 
pp. 1931-46). 

Not all commands, features, and facilities described in this manual are available in every UNIX System. The entries 
not applicable for a particular hardware line will have an appropriate caveat stamped in the center of the mast of an 
entry. Also, programs or facilities being phased out will be marked as ‘ ‘Obsolescent’ ’ on the top of the entry. When 
in doubt, consult your system’s administrator. 

This manual is divided into six sections, some containing inter-filed sub-classes: 

1. Commands and Application Programs: 

1. General-Purpose Commands. 

1C. Communications Commands. 

1G. Graphics Commands. 

2. System Calls. 

3. Subroutines: 

3C. C and Assembler Library Routines. 

3F. FORTRAN Library Routines. 

3M. Mathematical Library Routines. 

3S. Standard I/O Library Routines. 

3X. Miscellaneous Routines. 

4. File Formats. 

5. Miscellaneous Facilities. 

6. Games. 

Section 1 ( Commands and Application Programs) describes programs intended to be invoked directly by the user or 
by command language procedures, as opposed to subroutines, which are intended to be called by the user’s pro¬ 
grams. Commands generally reside in the directory /bin (for binary programs). Some programs also reside in 
/usr/bin, to save space in /bin. These directories are searched automatically by the command interpreter called the 
shell. Sub-class 1C contains communication programs such as cm, send, uucp, etc. These entries may not apply 
from system to system depending upon the hardware included on your processor. Some UNIX Systems may have a 
directory called /usr/lbin, containing local commands. 

Section 2 ( System Calls ) describes the entries into the UNIX System kernel, including the C language interface. 

Section 3 (Subroutines) describes the available subroutines. Their binary versions reside in various system libraries 
in the directories /lib and /usr/lib. See intro ( 3) for descriptions of these libraries and the files in which they are 
stored. 

Section 4 (File Formats) documents the structure of particular kinds of files; for example, the format of the output 
of the link editor is given in a.out( 4). Excluded are files used by only one command (for example, the assembler’s 
intermediate files). In general, the C language struct declarations corresponding to these formats can be found in the 
directories /usr/include and /usr/include/sys. 

Section 5 (Miscellaneous Facilities) contains a variety of things. Included are descriptions of character sets, macro 
packages, etc. 

Section 6 (Games) describes the games and educational programs that, as a rule, reside in the directory /usr/games. 

Each section consists of a number of independent entries of a page or so each. The name of the entry appears in the 
upper corners of its pages. Entries within each section are alphabetized, with the exception of the introductory entry 
that begins each section. The page numbers of each entry start at 1. Some entries may describe several routines, 
commands, etc. In such cases, the entry appears only once, alphabetized under its “major” name. 
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All entries are based on a common format, not all of whose parts always appear: 

The NAME part gives the name(s) of the entry and briefly states its puipose. 

The SYNOPSIS part summarizes the use of the program being described. A few conventions are used, particularly in Sec¬ 
tion 1 (Commands): 

Boldface strings are literals and are to be typed just as they appear. 

Italic strings usually represent substitutable argument prototypes and program names found elsewhere in the manual 
(they are underlined in the typed version of the entries). 

Square brackets [ ] around an argument prototype indicate that the argument is optional. When an argument prototype 
is given as “name” or “file”, it always refers to a file name. 

Ellipses ... are used to show that the previous argument prototype may be repeated. 

A final convention is used by the commands themselves. An argument beginning with a minus —, plus +, or equal sign 
= is often taken to be some sort of flag argument, even if it appears in a position where a file name could appear. 
Therefore, it is unwise to have files whose names begin with -, +, or =. 

The DESCRIPTION part discusses the subject at hand. 

The EXAMPLE(S) part gives example(s) of usage, where appropriate. 

The FILES part gives the file names that are built into the program. 

The SEE ALSO part gives pointers to related information. 

The DIAGNOSTICS part discusses the diagnostic indications that may be produced. Messages that are intended to be self- 
explanatory are not listed. 

The WARNINGS part points out potential pitfalls. 

The BUGS part gives known bugs and sometimes deficiencies. Occasionally, the suggested fix is also described. 

A table of contents and a permuted index derived from that table precede Section 1. On each index line, the title of the entry to 
which that line refers is followed by the appropriate section number in parentheses. This is important because there is consider¬ 
able duplication of names among the sections, arising principally from commands that exist only to exercise a particular system 
call. 

On most systems, all entries are available on-line via the man( 1) command, q.v. 
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HOW TO GET STARTED 


This discussion provides the basic information you need to get started on the UNIX System: how to log in and log out, how to 
communicate through your terminal, and how to run a program. (See the UNIX System User’s Guide for a more complete intro¬ 
duction to the system.) 

Logging in. You must dial up the UNIX System from an appropriate terminal. The UNIX System supports full-duplex ASCII ter¬ 
minals. You must also have a valid user name, which may be obtained (together with the telephone number(s) of your UNIX 
System) from the administrator of your system. Common terminal speeds are 10, 15, 30, and 120 characters per second (110, 
150, 300, and 1,200 baud); occasionally, speeds of 240, 480, and 960 characters per second (2,400, 4,800, and 9,600 baud) are 
also available. On some UNIX Systems, there are separate telephone numbers for each available terminal speed, while on other 
systems several speeds may be served by a single telephone number. In the latter case, there is one “preferred” speed; if you 
dial in from a terminal set to a different speed, you will be greeted by a string of meaningless characters (the login: message at 
the wrong speed). Keep hitting the “break” or “attention” key until the login: message appears. Hard-wired terminals usually 
are set to the correct speed. 

Most terminals have a speed switch that should be set to the appropriate speed and a half-/full-duplex switch that should be set to 
full-duplex. When a connection (at the speed of the terminal) has been established, the system types login: and you then type 
your user name followed by the “return” key. If you have a password (and you should!), the system asks for it, but does not 
print (“echo”) it on the terminal. After you have logged in, the “return”, “new-line”, and “line-feed” keys will give exactly 
the same result. 

It is important that you type your login name in lower case if possible; if you type upper-case letters, the UNIX System will 
assume that your terminal cannot generate lower-case letters and that you mean all subsequent upper-case input to be treated as 
lower case. When you have logged in successfully, the shell will type a $ to you. (The shell is described below under How to 
run a program .) 

For more information, consult login{ 1), which discuss the login sequence in more detail, and sffv(l), which tells you how to 
describe the characteristics of your terminal to the system ( profile (4) explains how to accomplish this last task automatically 
every time you log in). 

Logging out. There are two ways to log out: 

1. You can simply hang up the phone. 

2. You can log out by typing an end-of-file indication (ASCII EOT character, usually typed as “control-d”) to the shell. 
The shell will terminate and the login: message will appear again. 

How to communicate through your terminal. When you type to the UNIX System, a gnome deep in the system is gathering 
your characters and saving them. These characters will not be given to a program until you type a “return” (or “new-line”), as 
described above in Logging in. 

The UNIX System terminal input/output is full-duplex. It has full read-ahead, which means that you can type at any time, even 
while a program is typing at you. Of course, if you type during output, the output will have interspersed in it the input charac¬ 
ters. However, whatever you type will be saved and interpreted in the correct sequence. There is a limit to the amount of read- 
ahead, but it is generous and not likely to be exceeded unless the system is in trouble. When the read-ahead limit is exceeded, 
the system throws away all the saved characters. 

On an input line from a terminal, the character @ “kills” all the characters typed before it. The character # erases the last char¬ 
acter typed. Successive uses of # will erase characters back to, but not beyond, the beginning of the line; @ and # can be typed 
as themselves by preceding them with \ (thus, to erase a \, you need two #s). These default erase and kill characters can be 
changed; see stty(l). 

The ASCII DC3 (control-s) character can be used to temporarily stop output. It is useful with CRT terminals to prevent output 
from disappearing before it can be read. Output is resumed when a DC1 (control-q) or a second DC3 (or any other character, for 
that matter) is typed. The DC1 and DC3 characters are not passed to any other program when used in this manner. 

The ASCII DEL (a.k.a. “rubout”) character is not passed to programs, but instead generates an interrupt signal, just like the 
“break”, “interrupt”, or “attention” signal. This signal generally causes whatever program you are running to terminate. It is 
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typically used to stop a long printout that you don’t want. However, programs can arrange either to ignore this signal altogether, 
or to be notified when it happens (instead of being terminated). The editor ed( 1), for example, catches interrupts and stops what 
it is doing, instead of terminating, so that an interrupt can be used to halt an editor printout without losing the file being edited. 

The quit signal is generated by typing the ASCII FS character. It not only causes a running program to terminate, but also gener¬ 
ates a file with the “core image” of the terminated process. Quit is useful for debugging. 

Besides adapting to the speed of the terminal, the UNIX System tries to be intelligent as to whether you have a terminal with the 
“new-line” function, or whether it must be simulated with a “carriage-return” and “line-feed” pair. In the latter case, all input 
“carriage-return” characters are changed to “line-feed” characters (the standard line delimiter), and a “carriage-return” and 
“line-feed” pair is echoed to the terminal. If you get into the wrong mode, the sffv(l) command will rescue you. 

Tab characters are used freely in the UNIX System source programs. If your terminal does not have the tab function, you can 
arrange to have tab characters changed into spaces during output, and echoed as spaces during input. Again, the stty(l) com¬ 
mand will set or reset this mode. The system assumes that tabs are set every eight character positions. The tabs(l) command 
will set tab stops on your terminal, if that is possible. 

How to run a program. When you have successfully logged into the UNIX System, a program called the shell is listening to 
your terminal. The shell reads the lines you type, splits them into a command name and its arguments, and executes the com¬ 
mand. A command is simply an executable program. Normally, the shell looks first in your current directory (see The current 
directory below) for a program with the given name, and if none is there, then in system directories. There is nothing special 
about system-provided commands except that they are kept in directories where the shell can find them. You can also keep com¬ 
mands in your own directories and arrange for the shell to find them there. 

The command name is the first word on an input line to the shell; the command and its arguments are separated from one another 
by space and/or tab characters. 

When a program terminates, the shell will ordinarily regain control and type a $ at you to indicate that it is ready for another 
command. The shell has many other capabilities, which are described in detail in sh( 1). 

The current directory. The UNIX file system is arranged in a hierarchy of directories. When the system administrator gave you 
a user name, he or she also created a directory for you (ordinarily with the same name as your user name, and known as your 
login or home directory). When you log in, that directory becomes your current or working directory, and any file name you 
type is by default assumed to be in that directory. Because you are the owner of this directory, you have full permissions to read, 
write, alter, or destroy its contents. Permissions to have your will with other directories and files will have been granted or 
denied to you by their respective owners, or by the system administrator. To change the current directory use cd( 1). 

Path names. To refer to files not in the current directory, you must use a path name. Full path names begin with /, which is the 
name of the root directory of the whole file system. After the slash comes the name of each directory containing the next sub¬ 
directory (followed by a /), until finally the file name is reached (e.g., /usr/ae/filex refers to file filex in directory ae, while ae is 
itself a subdirectory of usr; usr springs directly from the root directory). See intro (2) for a formal definition of path name. 

If your current directory contains subdirectories, the path names of files therein begin with the name of the corresponding subdi¬ 
rectory (without a prefixed /). Without important exception, a path name may be used anywhere a file name is required. 

Important commands that modify the contents of files are cp( 1), mv, and rm( 1), which respectively copy, move (i.e., rename), 
and remove files. To find out the status of files or directories, use ls( \). Use mkdir( 1) for making directories and rmdir( 1) for 
destroying them. 

For a fuller discussion of the file system, see the references cited at the beginning of the INTRODUCTION above. It may also be 
useful to glance through Section 2 of this manual, which discusses system calls, even if you don’t intend to deal with the system 
at that level. 

Writing a program. To enter the text of a source program into a UNIX System file, use ed{ 1). The principal languages avail¬ 
able under the UNIX System are C (see cc(l)), Fortran (see/77(l)), and assembly language (see asTl)). After the program text 
has been entered with the editor and written into a file (whose name has the appropriate suffix), you can give the name of that file 
to the appropriate language processor as an argument. Normally, the output of the language processor will be left in a file in the 
current directory named a.out (if that output is precious, use mv( 1) to give it a less vulnerable name). If the program is written in 
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assembly language, you will probably need to load with it library subroutines (see Id( 1)). Fortran and C call the loader automati¬ 
cally. 

When you have finally gone through this entire process without provoking any diagnostics, the resulting program can be run by 
giving its name to the shell in response to the $ prompt. 

If any execution (run-time) errors occur, you will need sdb < 1) to examine the remains of your program. 

Your programs can receive arguments from the command line just as system programs do; see exec( 2). 

Text processing. Almost all text is entered through the editor ed{ 1). The commands most often used to write text on a terminal 
are cat( 1), pr( 1), and nroff. The cat( 1) command simply dumps ASCII text on the terminal, with no processing at all. The pr( 1) 
command paginates the text, supplies headings, and has a facility for multi-column output. Nroff is an elaborate text formatting 
program, and requires careful forethought in entering both the text and the formatting commands into the input file; it produces 
output on a typewriter-like terminal. Troff{ 1) is very similar to nroff , but produces its output on a phototypesetter (it was used to 
typeset this manual). There are several “macro” packages (especially the so-called mm package) that significantly ease the 
effort required to use nroff and troff( 1); Section 5 entries for these packages indicate where you can find their detailed descrip¬ 
tions. 

Surprises. Certain commands provide inter-user communication. Even if you do not plan to use them, it would be well to learn 
something about them, because someone else may aim them at you. To communicate with another user currently logged in, 
write(\) is used; mail(l) will leave a message whose presence will be announced to another user when he or she next logs in. 
The corresponding entries in this manual also suggest how to respond to these two commands if you are their target. 

When you log in, a message-of-the-day may greet you before the first $. 
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getopt.get option letter from argument vector 

getpass.read a password 

getpw .get name from UID 

getpwent.get password file entry 

gets.get a string from a stream 

getut.access utmp file entry 

hsearch.manage hash search tables 

hypot.Euclidean distance function 

index .return location of Fortran substring 

13tol.convert between 3-byte integers and long integers 

ldahread.read the archive header of a member of an archive file 

ldclose.close a common object file 

ldfhread.read the file header of a common object file 

ldlread.manipulate line number entries of a common object file function 

ldlseek.seek to line number entries of a section of a common object file 

ldohseek.seek to the optional file header of a common object file 

ldopen.open a common object file for reading 

ldrseek.seek to relocation entries of a section of a common object file 

ldshread.read an indexed/named section header of a common object file 

ldsseek.seek to an indexed/named section of a common object file 

ldtbindex.compute the index of a symbol table entry of a common object file 

ldtbread.read an indexed symbol table entry of a common object file 

ldtbseek.seek to the symbol table of a common object file 

len.return length of Fortran string 

log.Fortran natural logarithm intrinsic function 

log 10 .Fortran common logarithm intrinsic function 

logname.return login name of user 

lsearch.linear search and update 

malloc.main memory allocator 

matherr.error-handling function 

max.Fortran maximum-value functions 

rnclock.return Fortran time accounting 

memory.memory operations 
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PERMUTED INDEX 


/functions of HP 2640 and 2621-series terminals.hp(l) 

handle special functions of HP 2640 and 2621-series/hp:.hp(l) 

archiver, hpio: HP 2645A terminal tape file.hpio(l) 

functions of DASI 300 and/ 300, 300s: handle special . 300(1) 

/special functions of DASI 300 and 300s terminals. 300(1) 

of DASI 300 and 300s/ 300, 300s: handle special functions . 300(1) 

functions of DASI 300 and 300s terminals./special. 300(1) 

dis: 3B20S disassembler.dis(l) 

produce C source listing from 3B20S object file, list: .list(l) 

sys3b: 3B20S specific system calls.sys3b(2) 

system: format of 3B20S system description file.system(4) 

13tol, ltol3: convert between 3-byte integers and long/ .13tol(3C) 

comparison, diff3: 3-way differential file.diff3(l) 

Tektronix 4014 terminal. 4014: paginator for the .4014(1) 

paginator for the Tektronix 4014 terminal. 4014:. 4014(1) 

of the DASI 450 terminal. 450: handle special functions. 450(1) 

special functions of the DASI 450 terminal. 450: handle. 450(1) 

files from the HONEYWELL 6000. /fget.demon: retrieve .fget(lC) 

send files to the HONEYWELL 6000. fsend: .fsend(lC) 

output to the HONEYWELL 6000./send phototypesetter .gcat(lC) 

f77: Fortran 77 compiler.f77(l) 

long integer and base-64/ a641,164a: convert between .a641(3C) 

abort: generate an IOT fault.abort(3C) 

program, abort: terminate Fortran.abort(3F) 

Fortran absolute value, abs, iabs, dabs, cabs, zabs:.abs(3F) 

value, abs: return integer absolute.abs(3C) 

adb: absolute debugger.adb(l) 

abs: return integer absolute value.abs(3C) 

dabs, cabs, zabs: Fortran absolute value, abs, iabs, .abs(3F) 

/floor, ceiling, remainder, absolute value functions.floor(3M) 

of a file, touch: update access and modification times .touch(l) 

utime: set file access and modification times.utime(2) 

accessibility of a file, access: determine .access(2) 

commands, graphics: access graphical and numerical.graphics(lG) 

machine/ sputl, sgetl: access long numeric data in a.sputl(3X) 

sadp: disk access profiler.sadp(l) 

ldfcn: common object file access routines.ldfcn(4) 

/setutent, endutent, utmpname: access utmp file entry.getut(3C) 

access: determine accessibility of a file.access(2) 

enable or disable process accounting, acct: .acct(2) 

acct: per-process accounting file format.acct(4) 

search and print process accounting file(s). acctcom: .acctcom(l) 

mclock: return Fortran time accounting.mclock(3F) 

process accounting, acct: enable or disable .acct(2) 

file format, acct: per-process accounting.acct(4) 

process accounting file(s). acctcom: search and print .acctcom(l) 

sin, cos, tan, asin, acos, atan, atan2:/ .trig(3M) 

intrinsic function, acos, dacos: Fortran arccosine .acos(3F) 

sag: system activity graph.sag(lG) 

sar: system activity reporter.sar(l) 

current SCCS file editing activity, sact: print.sact(l) 

report process data and system activity, /time a command;.timex(l) 

formatting/ mosd: the OSDD adapter macro package for.mosd(5) 

adb: absolute debugger.adb(l) 

SCCS files, admin: create and administer.admin(l) 

admin: create and administer SCCS files.admin(l) 

imaginary part of complex/ aimag, dimag: Fortran .aimag(3F) 

part intrinsic function, aint, dint: Fortran integer .aint(3F) 

alarm: set a process’s alarm clock.alarm(2) 

clock, alarm: set a process’s alarm .alarm(2) 

change data segment space allocation, brk, sbrk:.brk(2) 

realloc, calloc: main memory allocator, malloc, free, .malloc(3C) 

natural logarithm/ log, alog, dlog, clog: Fortran.log(3F) 

logarithm intrinsic/log 10, alog 10, dlog 10: Fortran common .logl0(3F) 

Fortran/ max, maxO, amaxO, maxi, amaxl, dmaxl: .max(3F) 

max, maxO, amaxO, maxi, amaxl, dmaxl: Fortran/.max(3F) 

Fortran/ min, minO, aminO, mini, aminl, dminl:.min(3F) 
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Permuted Index 


min, minO, aminO, mini, 
remaindering intrinsic/ mod, 
rshift: Fortran bitwise/ 
sort: sort 
send, gath: gather files 
Fortran nearest integer/ 
link editor output, 
link editor output, 
introduction to commands and 
maintainer. 
maintainer for portable/ 

format, 
language, be: 
acos, dacos: Fortran 
maintainer. ar: 
for portable archives, ar: 
cpio: format of cpio 
ar: common 
ar: 

header of a member of an 
common archive/ arev: convert 
convert: convert object and 
files from PDP-11 to common 
an archive/ ldahread: read the 
HP 2645A terminal tape file 
tar: tape file 
maintainer for portable 
cpio: copy file 
asin, dasin: Fortran 
atan2, datan2: Fortran 
atan, datan: Fortran 
from PDP-11 to common archive/ 
imaginary part of complex 
return Fortran command-line 
command, xargs: construct 
getopt: get option letter from 
expr: evaluate 
echo:echo 
be: arbitrary-precision 
number facts, 
expr: evaluate arguments 

characters, asa: interpret 
control characters, 
ascii: map of 
set. 

long integer and base-64 
number, atof: convert 
and/ ctime, localtime, gmtime, 
trigonometric/ sin, cos, tan, 
intrinsic function. 

help: 

output, a.out: common 
output, a.out: PDP-11 
as: common 
as: 

KMC11B/ kasb, kunb: 

assertion, 
assert: verify program 
setbuf: 

sin, cos, tan, asin, acos, 
arctangent intrinsic/ 
arctangent intrinsic/ 
cos, tan, asin, acos, atan, 
floating-point number, 
integer, strtol, atol, 
integer, strtol, 
link. x25alnk, x25ilnk: 

wait: 

processing language. 


aminl, dminl: Fortran/.min(3F) 

amod, dmod: Fortran.mod(3F) 

and, or, xor, not, lshift, .bool(3F) 

and/or merge files.sort(l) 

and/or submit RJE jobs.send(lC) 

anint, dnint, nint, idnint:.round(3F) 

a.out: common assembler and .a.out(4) 

a.out: PDP-11 assembler and.a.out.pdp(4) 

application programs, intro: .intro(l) 

ar: archive and library.ar.pdp(l) 

ar: archive and library.ar(l) 

ar: archive file format.ar.pdp(4) 

ar: common archive file.ar(4) 

arbitrary-precision arithmetic.bc(l) 

arccosine intrinsic function.acos(3F) 

archive and library.ar.pdp(l) 

archive and library maintainer .ar(l) 

archive.cpio(4) 

archive file format.ar(4) 

archive file format.ar.pdp(4) 

archive file, /the archive.ldahread(3X) 

archive files from PDP-11 to.arcv(l) 

archive files to common/ .convert(l) 

archive format, /archive.arcv(l) 

archive header of a member of.ldahread(3X) 

archiver, hpio: .hpio(l) 

archiver.tar(l) 

archives./archive and library.ar( 1) 

archives in and out.cpio(l) 

arcsine intrinsic function.asin(3F) 

arctangent intrinsic function.atan2(3F) 

arctangent intrinsic function.atan(3F) 

arev: convert archive files.arcv(l) 

argument, /dimag: Fortran.aimag(3F) 

argument, getarg: .getarg(3F) 

argument list(s) and execute.xargs(l) 

argument vector.getopt(3C) 

arguments as an expression.expr(l) 

arguments.echo( 1) 

arithmetic language.bc(l) 

arithmetic: provide drill in.arithmetic(6) 

as an expres sion.expr( 1) 

as: assembler for PDP-11.as.pdp(l) 

as: common assembler.as(l) 

AS A carriage control.asa(l) 

asa: interpret ASA carriage.asa(l) 

ASCII character set.ascii(5) 

ascii: map of ASCII character .ascii(5) 

ASCII string, /convert between.a641(3C) 

ASCII string to floating-point.atof(3C) 

asetime, tzset: convert date.ctime(3C) 

asin, acos, atan, atan2: .trig(3M) 

asin, dasin: Fortran arcsine.asin(3F) 

ask for help.help( 1) 

assembler and link editor .a.out(4) 

assembler and link editor .a.out.pdp(4) 

assembler.as(l) 

assembler for PDP-11.as.pdp( 1) 

assembler/un-assembler for the.kasb(l) 

assert: verify program.assert(3X) 

assertion.assert(3X) 

assign buffering to a stream.setbuf(3S) 

atan, atan2: trigonometric/.trig(3M) 

atan, datan: Fortran.atan(3F) 

atan2, datan2: Fortran.atan2(3F) 

atan2: trigonometric/ sin, .trig(3M) 

atof: convert ASCII string to.atof(3C) 

atoi: convert string to.strtol(3C) 

atol, atoi: convert string to.strtol(3C) 

attach or install a BX.25 .x25alnk(3C) 

await completion of process.wait(l) 

awk: pattern scanning and.awk(l) 
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ungetc: push character back into input stream.ungetc(3S) 

back: the game of backgammon.back(6) 

back: the game of backgammon.back(6) 

banner: make posters.banner(l) 

between long integer and base-64 ASCII string, /convert.a641(3C) 

portions of path names, basename, dimame: deliver .basename(l) 

arithmetic language, be: arbitrary-precision.bc(l) 

bdiff: big diff.bdiff(l) 

cb: C program beautifier.cb(l) 

jO, j 1, jn, yO, y 1, yn: Bessel functions.bessel(3M) 

bfs: big file scanner.bfs(l) 

fread, fwrite: binary input/output.fread(3S) 

bsearch: binary search.bsearch(3C) 

tdelete, twalk: manage binary search trees, tsearch, .tsearch(3C) 

remove symbols and relocation bits, strip: .strip.pdp(l) 

/not, lshift, rshift: Fortran bitwise boolean functions.bool(3F) 

bj: the game of black jack.bj(6) 

bj: the game of blackjack.bj(6) 

sum: print checksum and block count of a file.sum(l) 

sync: update the super block.sync(l) 

rshift: Fortran bitwise boolean functions, /lshift,.bool(3F) 

space allocation, brk, sbrk: change data segment.brk(2) 

modest-sized programs, bs: a compiler/interpreter for.bs(l) 

bsearch: binary search.bsearch(3C) 

stdio: standard buffered input/output package.stdio(3S) 

setbuf: assign buffering to a stream.setbuf(3S) 

x25ilnk: attach or install a BX.25 link. x25alnk,.x25alnk(3C) 

x25clnk: change over a BX.25 link.x25clnk(3C) 

x25dlnk: halt or detach a BX.25 link. x25hlnk,.x25hlnk(3C) 

swab: swap bytes.swab(3C) 

cc, pcc: C compiler.cc(l) 

programs, see: C compiler for stand-alone.scc(l) 

cflow: generate C flow graph.cflow(l) 

epp: the C language preprocessor.cpp(l) 

cb: C program beautifier.cb(l) 

lint: a C program checker.lint(l) 

cxref: generate C program cross reference.cxref(l) 

object file, list: produce C source listing from 3B20S.list(l) 

value, abs, iabs, dabs, cabs, zabs: Fortran absolute .abs(3F) 

cal: print calendar.cal(l) 

dc: desk calculator.dc(l) 

cal: print calendar.cal(l) 

calendar: reminder service.calendar(l) 

cu: call another UNIX system.cu(lC) 

data returned by stat system call, stat:.stat(5) 

malloc, free, realloc, calloc: main memory allocator.malloc(3C) 

intro: introduction to system calls and error numbers.intro(2) 

sys3b: 3B20S specific system calls.sys3b(2) 

to an LP line printer. Ip, cancel: send/cancel requests .lp( 1) 

pnch: file format for card images.pnch(4) 

asa: interpret ASA carriage control characters.asa(l) 

files, cat: concatenate and print .cat(l) 

cb: C program beautifier.cb(l) 

cc, pcc: C compiler.cc(l) 

function, cos, dcos, ccos: Fortran cosine intrinsic.cos(3F) 

cd: change working directory.cd(l) 

commentary of an SCCS delta, ede: change the delta.cdc(l) 

ceiling, remainder,/ floor, ceil, fmod, fabs: floor, .floor(3M) 

/ceil, fmod, fabs: floor, ceiling, remainder, absolute/.floor(3M) 

intrinsic/ exp, dexp, cexp: Fortran exponential.exp(3F) 

cflow: generate C flow graph.cflow(l) 

delta: make a delta (change) to an SCCS file.delta(l) 

pipe: create an interprocess channel.pipe(2) 

/dble, cmplx, dcmplx, ichar, char: explicit Fortran type/.ftype(3F) 

stream, ungetc: push character back into input .ungetc(3S) 

and neqn. eqnchar: special character definitions for eqn .eqnchar(5) 

user, cuserid: get character login name of the .cuserid(3S) 

/getchar, fgetc, getw: get character or word from stream.getc(3S) 

/putchar, fputc, putw: put character or word on a stream.putc(3S) 

ascii: map of ASCII character set.ascii(5) 

interpret AS A carriage control characters, asa: .asa(l) 

_tolower, toascii: translate characters. /_toupper,.conv(3C) 
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iscntrl, isascii: classify 
tr: translate 
directory, 
constant-width text for/ cw, 
text for nroff or/ eqn, neqn, 
lint: a C program 
systems processed by fsck. 
formatted with the/ mm, osdd, 
file, sum: print 
chess: the game of 

chown, 

times: get process and 
terminate, wait: wait for 

of a file, 
group. 

isgraph, iscntrl, isascii: 
status/ ferror, feof, 
alarm: set a process’s alarm 

logarithm/ log, alog, dlog, 
ldclose, ldaclose: 

close: 
descriptor, 
fclose, fflush: 

/real, float, sngl, dble, 
line-feeds. 

comb: 

common to two sorted files. 

nice: run a 
env: set environment for 
uux: unix to unix 
system: issue a shell 
quits, nohup: run a 
net: execute a 
getopt: parse 
/shell, the standard/restricted 
and system/ timex: time a 
system: issue a shell 
test: condition evaluation 
time: time a 
argument list(s) and execute 
getarg: return Fortran 
intro: introduction to 
access graphical and numerical 
network useful with graphical 
cdc: change the delta 
ar: 

/archive files from PDP-11 to 
editor output, a.out: 

as: 

object and archive files to 
log 10, alog 10, dlog 10: Fortran 
routines, ldfcn: 
ldopen, ldaopen: open a 
/line number entries of a 
ldclose, ldaclose: close a 
read the file header of a 
entries of a section of a 
the optional file header of a 
/entries of a section of a 
/section header of a 
an indexed/named section of a 
of a symbol table entry of a 
symbol table entry of a 
seek to the symbol table of a 
line number entries in a 


characters, /isprint, isgraph, .ctype(3C) 

characters.tr(l) 

chdir: change working .chdir(2) 

checkcw: prepare .cw(l) 

checkeq: format mathematical .eqn(l) 

checker.lint(l) 

checklist: list of file .checklist(4) 

checkmm: print/check documents.mm(l) 

checksum and block count of a.sum(l) 

chess.chess(6) 

chess: the game of chess.chess(6) 

chgrp: change owner or group.chown(l) 

child process times.times(2) 

child process to stop or.wait(2) 

chmod: change mode.chmod(l) 

chmod: change mode of file.chmod(2) 

chown: change owner and group .chown(2) 

chown, chgrp: change owner or.chown(l) 

chroot: change root directory.chroot(2) 

classify characters, /isprint, .ctype(3C) 

clearerr, fileno: stream .ferror(3S) 

clock.alarm(2) 

clock: report CPU time used.clock(3C) 

clog: Fortran natural .log(3F) 

close a common object file.ldclose(3X) 

close a file descriptor.close(2) 

close: close a file.close(2) 

close or flush a stream.fclose(3S) 

cmp: compare two files.cmp(l) 

cmplx, dcmplx, ichar, char:/.ftype(3F) 

col: filter reverse.col(l) 

comb: combine SCCS deltas.comb(l) 

combine SCCS deltas.comb(l) 

comm: select or reject lines .comm(l) 

command at low priority.nice(l) 

command execution.env(l) 

command execution.uux(lC) 

command from Fortran.system(3F) 

command immune to hangups and.nohup(l) 

command on the PCL network.net(lC) 

command options.getopt(l) 

command programming language.sh(l) 

command; report process data .timex(l) 

command.system(3S) 

command.test(l) 

command.time(l) 

command, xargs: construct .xargs(l) 

command-line argument.getarg(3F) 

commands and application/ .intro(l) 

commands, graphics:.graphics(lG) 

commands, stat: statistical.stat(lG) 

commentary of an SCCS delta.cdc(l) 

common archive file format.ar(4) 

common archive format.arcv(l) 

common assembler and link.a.out(4) 

common assembler.as(l) 

common formats, /convert.convert(l) 

common logarithm intrinsic/.logl0(3F) 

common object file access.ldfcn(4) 

common object file for/.ldopen(3X) 

common object file function.ldlread(3X) 

common object file.ldclose(3X) 

common object file, ldfhread: .ldfhread(3X) 

common object file, /number.ldlseek(3X) 

common object file, /seek to.ldohseek(3X) 

common object file.ldrseek(3X) 

common object file.ldshread(3X) 

common object file, /seek to.ldsseek(3X) 

common object file, /the index.ldtbindex(3X) 

common object file, /indexed.ldtbread(3X) 

common object file, ldtbseek: .ldtbseek(3X) 

common object file, linenum: .linenum(4) 
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nm: print name list of common object file.nm(l) 

relocation information for a common object file, reloc:.reloc(4) 

scnhdr: section header for a common object file.scnhdr(4) 

line number information from a common object file./and .strip(l) 

table format, syms: common object file symbol .syms(4) 

filehdr: file header for common object files.filehdr(4) 

Id: link editor for common object files.ld(l) 

size: print section sizes of common object files.size(l) 

comm: select or reject lines common to two sorted files.comm(l) 

ipcs: report inter-process communication facilities/ .ipcs(l) 

stdipc: standard interprocess communication package.stdipc(3C) 

diff: differential file comparator.diff(l) 

cmp: compare two files.cmp(l) 

SCCS file, sccsdiff: compare two versions of an .sccsdiff(l) 

diff3: 3-way differential file comparison.diff3(l) 

diremp: directory comparison.dircmp(l) 

expression, regemp, regex: compile and execute regular.regcmp(3X) 

regexp: regular expression compile and match routines.regexp(5) 

regemp: regular expression compile.regcmp(l) 

cc, pcc: C compiler.cc(l) 

f77: Fortran 77 compiler.f77(l) 

programs, see: C compiler for stand-alone.scc(l) 

yacc: yet another compiler-compiler.yacc(l) 

modest-sized programs, bs: a compiler/interpreter for.bs(l) 

erf, erfc: error function and complementary error function.erf(3M) 

wait: await completion of process.wait(l) 

Fortran imaginary part of complex argument, /dimag: .aimag(3F) 

conjg, dconjg: Fortran complex conjugate intrinsic/.conjg(3F) 

cprs: compress an IS25 object file.cprs(l) 

pack, peat, unpack: compress and expand files.pack(l) 

table entry of a J ldtbindex: compute the index of a symbol.ldtbindex(3X) 

cat: concatenate and print files.cat(l) 

synchronous printer, scat: concatenate and print files on.scat(l) 

test: condition evaluation command.test(l) 

conjugate intrinsic function, conjg, dconjg: Fortran complex.conjg(3F) 

conjg, dconjg: Fortran complex conjugate intrinsic function.conjg(3F) 

an out-going terminal line connection, dial: establish.dial(3C) 

report and interactive status console, rjestat: RJE status.rjestat(lC) 

cw, checkcw: prepare constant-width text for troff.cw(l) 

execute command, xargs: construct argument list(s) and.xargs(l) 

nroff/troff, tbl, and eqn constructs, deroff: remove.deroff(l) 

Is: list contents of directories.ls(l) 

toe: graphical table of contents routines.toc(lG) 

esplit: context split.csplit(l) 

asa: interpret AS A carriage control characters.asa(l) 

ioctl: control device.ioctl(2) 

fcntl: file control.fcntl(2) 

msgctl: message control operations.msgctl(2) 

semctl: semaphore control operations.semctl(2) 

shmctl: shared memory control operations.shmctl(2) 

fcntl: file control options.fcntl(5) 

uucp status inquiry and job control, uustat: .uustat(lC) 

vc: version control.vc(l) 

terminals, term: conventional names for.term(5) 

char: explicit Fortran type conversion, /dcmplx, ichar, .ftype(3F) 

units: conversion program.units(l) 

dd: convert and copy a file.dd(l) 

PDP-11 to common/ arev: convert archive files from.arcv(l) 

floating-point number, atof: convert ASCII string to.atof(3C) 

integers and/ 13tol, ltol3: convert between 3-byte.13tol(3C) 

and base-64 ASCII/ a641,164a: convert between long integer.a641(3C) 

archive files to common/ convert: convert object and .convert(l) 

/gmtime, asetime, tzset: convert date and time to/ .ctime(3C) 

to string, ecvt, fevt, gevt: convert floating-point number .ecvt(3C) 

scanf, fscanf, sscanf: convert formatted input.scanf(3S) 

files to common/convert: convert object and archive.convert(l) 

strtol, atol, atoi: convert string to integer.strtol(3C) 

dd: convert and copy a file.dd(l) 

cpio: copy file archives in and out.cpio(l) 

cp, In, mv: copy, link or move files.cp(l) 

uulog, uuname: unix to unix copy, uucp,.uucp(lC) 

public UNIX-to-UNIX file copy, uuto, uupick: .uuto(lC) 
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Permuted Index 


file, core: format of core image.core(4) 

core: format of core image file.core(4) 

cosine intrinsic function, cos, dcos, ccos: Fortran.cos(3F) 

atan2: trigonometric/ sin, cos, tan, asin, acos, atan,.trig(3M) 

hyperbolic cosine intrinsic/ cosh, dcosh: Fortran .cosh(3F) 

functions, sinh, cosh, tanh: hyperbolic.sinh(3M) 

cos, dcos, ccos: Fortran cosine intrinsic function.cos(3F) 

/dcosh: Fortran hyperbolic cosine intrinsic function.cosh(3F) 

sum: print checksum and block count of a file.sum(l) 

wc: word count.wc(l) 

files, cp, In, mv: copy, link or move .cp(l) 

cpio: format of cpio archive.cpio(4) 

and out. cpio: copy file archives in.cpio(l) 

cpio: format of cpio archive.cpio(4) 

preprocessor, cpp: the C language .cpp(l) 

file, cprs: compress an IS25 object .cprs(l) 

clock: report CPU time used.clock(3C) 

craps: the game of craps.craps(6) 

craps: the game of craps.craps(6) 

rewrite an existing one. creat: create a new file or .creat(2) 

file, tmpnam, tempnam: create a name for a temporary .tmpnam(3S) 

an existing one. creat: create a new file or rewrite.creat(2) 

fork: create a new process.fork(2) 

tmpfile: create a temporary file.tmpfile(3S) 

channel, pipe: create an interprocess.pipe(2) 

files, admin: create and administer SCCS .admin(l) 

umask: set and get file creation mask.umask(2) 

cxref: generate C program cross reference.cxref(l) 

crypt: encode/decode.crypt( 1) 

generate DES encryption, crypt, setkey, encrypt:.crypt(3C) 

function, sin, dsin, csin: Fortran sine intrinsic.sin(3F) 

csplit: context split.csplit(l) 

intrinsic/ sqrt, dsqrt, csqrt: Fortran square root .sqrt(3F) 

terminal, ct: spawn getty to a remote.ct(lC) 

for terminal, ctermid: generate file name.ctermid(3S) 

asctime, tzset: convert date/ ctime, localtime, gmtime, .ctime(3C) 

cu: call another UNIX system.cu(lC) 

ttt, cubic: tic-tac-toe.ttt(6) 

activity, sact: print current SCCS file editing .sact(l) 

uname: print name of current UNIX system.uname(l) 

uname: get name of current UNIX system.uname(2) 

slot in the utmp file of the current user, /find the.ttyslot(3C) 

getcwd: get path-name of current working directory.getcwd(3C) 

spline: interpolate smooth curve.spline(lG) 

name of the user, cuserid: get character login.cuserid(3S) 

of each line of a file, cut: cut out selected fields.cut(l) 

each line of a file, cut: cut out selected fields of.cut(l) 

constant-width text for/ cw, checkcw: prepare.cw(l) 

cross reference, cxref: generate C program.cxref(l) 

absolute value, abs, iabs, dabs, cabs, zabs: Fortran.abs(3F) 

intrinsic function, acos, dacos: Fortran arccosine.acos(3F) 

sending daemon, line printer daemon, dpd, lpd: HONEYWELL .dpd(lC) 

dpd, lpd: HONEYWELL sending daemon, line printer daemon.dpd(lC) 

/handle special functions of DASI 300 and 300s terminals. 300(1) 

special functions of the DASI 450 terminal./handle. 450(1) 

intrinsic function, asin, dasin: Fortran arcsine.asin(3F) 

/time a command; report process data and system activity.timex(l) 

/sgetl: access long numeric data in a machine independent/.sputl(3X) 

plock: lock process, text, or data in memory.plock(2) 

prof: display profile data.prof(l) 

call, stat: data returned by stat system .stat(5) 

brk, sbrk: change data segment space allocation.brk(2) 

types: primitive system data types.types(5) 

join: relational database operator.join(l) 

intrinsic function, atan, datan: Fortran arctangent .atan(3F) 

intrinsic function. atan2, datan2: Fortran arctangent.atan2(3F) 

/asctime, tzset: convert date and time to string.ctime(3C) 

date: print and set the date.date(l) 

date: print and set the date.date(l) 

/idint, real, float, sngl, dble, cmplx, dcmplx, ichar,/.ftype(3F) 

dc: desk calculator.dc(l) 

/float, sngl, dble, cmplx, dcmplx, ichar, char: explicit/.ftype(3F) 
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Permuted Index 


conjugate intrinsic/ conjg, dconjg: Fortran complex .conjg(3F) 

intrinsic function, cos, dcos, ccos: Fortran cosine.cos(3F) 

cosine intrinsic/ cosh, dcosh: Fortran hyperbolic.cosh(3F) 

dd: convert and copy a file.dd(l) 

adb: absolute debugger.adb(l) 

sdb: symbolic debugger.sdb(l) 

eqnchar: special character definitions for eqn and neqn.eqnchar(5) 

names, basename, dimame: deliver portions of path.basename(l) 

file, tail: deliver the last part of a.tail(l) 

delta commentary of an SCCS delta, ede: change the.cdc(l) 

file, delta: make a delta (change) to an SCCS.delta(l) 

delta, ede: change the delta commentary of an SCCS .cdc(l) 

rmdel: remove a delta from an SCCS file.rmdel(l) 

to an SCCS file, delta: make a delta (change) .delta(l) 

comb: combine SCCS deltas.comb(l) 

mesg: permit or deny messages.mesg(l) 

tbl, and eqn constructs, deroff: remove nroff/troff,.deroff(l) 

setkey, encrypt: generate DES encryption, crypt,.crypt(3C) 

system: format of 3B20S system description file.system(4) 

close: close a file descriptor.close(2) 

dup: duplicate an open file descriptor.dup(2) 

dc: desk calculator.dc(l) 

x25hlnk, x25dlnk: halt or detach a BX.25 link.x25hlnk(3C) 

file, access: determine accessibility of a .access(2) 

file: determine file type.file(l) 

master: master device information table.master.dec(4) 

master: master device information table.master.u3b(4) 

ioctl: control device.ioctl(2) 

/tekset, td: graphical device routines and filters.gdev(lG) 

exponential intrinsic/ exp, dexp, cexp: Fortran.exp(3F) 

terminal line connection, dial: establish an out-going.dial(3C) 

ratfor: rational Fortran dialect.ratfor(l) 

bdiff: big diff.bdiff(l) 

comparator, diff: differential file .diff(l) 

comparison. diff3: 3-way differential file .diff3(l) 

sdiff: side-by-side difference program.sdiff(l) 

diffmk: mark differences between files.diffmk(l) 

diff: differential file comparator.diff(l) 

diff3: 3-way differential file comparison.diff3(l) 

between files, diffmk: mark differences .diffmk(l) 

of complex argument, aimag, dimag: Fortran imaginary part .aimag(3F) 

intrinsic function, aint, dint: Fortran integer part.aint(3F) 

dir: format of directories.dir(4) 

diremp: directory comparison.dircmp(l) 

dir: format of directories.dir(4) 

Is: list contents of directories.ls(l) 

rm, rmdir: remove files or directories.rm(l) 

cd: change working directory.cd(l) 

chdir: change working directory.chdir(2) 

chroot: change root directory.chroot(2) 

diremp: directory comparison.dircmp(l) 

unlink: remove directory entry.unlink(2) 

path-name of current working directory, getewd: get .getcwd(3C) 

mkdir: make a directory.mkdir(l) 

pwd: working directory name.pwd(l) 

ordinary file, mknod: make a directory, or a special or.mknod(2) 

path names, basename, dirname: deliver portions of .basename(l) 

dis: 3B20S disassembler.dis(l) 

printers, enable, disable: enable/disable LP.enable(l) 

acct: enable or disable process accounting.acct(2) 

dis: 3B20S disassembler.dis(l) 

sadp: disk access profiler.sadp(l) 

du: summarize disk usage.du(l) 

prof: display profile data.prof(l) 

hypot: Euclidean distance function.hypot(3M) 

/lcong48: generate uniformly distributed pseudo-random/ .drand48(3C) 

logarithm/ log, alog, dlog, clog: Fortran natural.log(3F) 

logarithm/log 10, alog 10, dlog 10: Fortran common .logl0(3F) 

max, maxO, amaxO, maxi, amaxl, dmaxl: Fortran maximum-value/.max(3F) 

min, minO, aminO, mini, aminl, dminl: Fortran minimum-value/ .min(3F) 

intrinsic/ mod, amod, dmod: Fortran remaindering.mod(3F) 

nearest integer/ anint, dnint, nint, idnint: Fortran.round(3F) 
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mm, osdd, checkmm: print/check documents formatted with the/.mm(l) 

macro package for formatting documents, mm: the MM.mm(5) 

macro package for formatting documents, /the OSDD adapter.mosd(5) 

slides, mmt, mvt: typeset documents, view graphs, and.mmt(l) 

daemon, line printer daemon, dpd, lpd: HONEYWELL sending.dpd(lC) 

dpr: off-line print.dpr(lC) 

reversi: a game of dramatic reversals.reversi(6) 

nrand48, mrand48, jrand48,/ drand48, erand48, lrand48,.drand48(3C) 

graph: draw a graph.graph(lG) 

arithmetic: provide drill in number facts.arithmetic(6) 

transfer-of-sign/ sign, isign, dsign: Fortran.sign(3F) 

intrinsic function, sin, dsin, csin: Fortran sine .sin(3F) 

intrinsic function, sinh, dsinh: Fortran hyperbolic sine .sinh(3F) 

root intrinsic/ sqrt, dsqrt, csqrt: Fortran square.sqrt(3F) 

intrinsic function, tan, dtan: Fortran tangent.tan(3F) 

tangent intrinsic/ tanh, dtanh: Fortran hyperbolic .tanh(3F) 

du: summarize disk usage.du(l) 

an object file, dump: dump selected parts of.dump(l) 

od: octal dump.od(l) 

object file, dump: dump selected parts of an .dump(l) 

descriptor, dup: duplicate an open file.dup(2) 

descriptor, dup: duplicate an open file.dup(2) 

echo: echo arguments.echo(l) 

echo: echo arguments.echo( 1) 

floating-point number to/ ecvt, fcvt, gcvt: convert.ecvt(3C) 

ed, red: text editor.ed(l) 

program, end, etext, edata: last locations in .end(3C) 

sact: print current SCCS file editing activity.sact(l) 

ed, red: text editor.ed(l) 

files. Id: link editor for common object .ld(l) 

se: screen editor for video terminals.se(l) 

ged: graphical editor.ged(lG) 

Id: link editor.ld.pdp(l) 

common assembler and link editor output, a.out: .a.out(4) 

PDP-11 assembler and link editor output, a.out: .a.out.pdp(4) 

sed: stream editor.sed(l) 

/user, real group, and effective group IDs.getuid(2) 

and/ /getegid: get real user, effective user, real group, .getuid(2) 

Language, efl: Extended Fortran.efl(l) 

fsplit: split f77, ratfor, or efl files.fsplit(l) 

for a pattern, grep, egrep, fgrep: search a file .grep(l) 

enable/disable LP printers, enable, disable: .enable(l) 

accounting, acct: enable or disable process .acct(2) 

enable, disable: enable/disable LP printers.enable(l) 

crypt: encode/decode.crypt(l) 

encryption, crypt, setkey, encrypt: generate DES .crypt(3C) 

setkey, encrypt: generate DES encryption, crypt, .crypt(3C) 

makekey: generate encryption key.makekey(l) 

locations in program, end, etext, edata: last.end(3C) 

/getgrgid, getgmam, setgrent, endgrent: get group file/.getgrent(3C) 

/getpwuid, getpwnam, setpwent, endpwent: get password file/.getpwent(3C) 

utmp/ /pututline, setutent, endutent, utmpname: access .getut(3C) 

nlist: get entries from name list.nlist(3C) 

file, linenum: line number entries in a common object.linenum(4) 

man, manprog: print entries in this manual.man(l) 

man: macros for formatting entries in this manual.man(5) 

file/ /manipulate line number entries of a common object.ldlread(3X) 

common/ /seek to line number entries of a section of a.ldlseek(3X) 

/ldnrseek: seek to relocation entries of a section of a/.ldrseek(3X) 

utmp, wtmp: utmp and wtmp entry formats.utmp(4) 

endgrent: get group file entry, /getgrnam, setgrent,.getgrent(3C) 

endpwent: get password file entry, /getpwnam, setpwent,.getpwent(3C) 

utmpname: access utmp file entry, /setutent, endutent,.getut(3C) 

/the index of a symbol table entry of a common object file.ldtbindex(3X) 

/read an indexed symbol table entry of a common object file.ldtbread(3X) 

putpwent: write password file entry.putpwent(3C) 

unlink: remove directory entry.unlink(2) 

command execution, env: set environment for.env(l) 

environ: user environment.environ(5) 

profile: setting up an environment at login time.profile(4) 

environ: user environment.environ(5) 

execution, env: set environment for command.env(l) 












































































Permuted Index 


getenv: return value for environment name.getenv(3C) 

getenv: return Fortran environment variable.getenv(3F) 

sky: obtain ephemerides.sky(6) 

character definitions for eqn and neqn. /special .eqnchar(5) 

remove nroff/troff, tbl, and eqn constructs, deroff: .deroff(l) 

mathematical text for nroff/ eqn, neqn, checkeq: format.eqn(l) 

definitions for eqn and neqn. eqnchar: special character.eqnchar(5) 

mrand48, jrand48,/ drand48, erand48, lrand48, nrand48,.drand48(3C) 

graphical device/ hpd, erase, hardcopy, tekset, td:.gdev(lG) 

complementary error function, erf, erfc: error function and.erf(3M) 

complementary error/ erf, erfc: error function and.erf(3M) 

format, errfile: error-log file .errfile(4) 

system error/ perror, errno, sys_errlist, sys_nerr:.perror(3C) 

complementary/ erf, erfc: error function and .erf(3M) 

function and complementary error function, /erfc: error.erf(3M) 

sys_errlist, sys_nerr: system error messages, /errno, .perror(3C) 

to system calls and error numbers, /introduction.intro(2) 

matherr: error-handling function.matherr(3M) 

errfile: error-log file format.errfile(4) 

hashcheck: find spelling errors./hashmake, spellin,.spell(l) 

terminal line/ dial: establish an out-going.dial(3C) 

in program, end, etext, edata: last locations.end(3C) 

hypot: Euclidean distance function.hypot(3M) 

expression, expr: evaluate arguments as an .expr(l) 

test: condition evaluation command.test(l) 

execlp, execvp: execute a/ execl, execv, execle, execve,.exec(2) 

execvp: execute/ execl, execv, execle, execve, execlp, .exec(2) 

execl, execv, execle, execve, execlp, execvp: execute a/.exec(2) 

network, net: execute a command on the PCL.net(lC) 

execve, execlp, execvp: execute a file, /execle, .exec(2) 

construct argument list(s) and execute command, xargs:.xargs(l) 

regcmp, regex: compile and execute regular expression.regcmp(3X) 

set environment for command execution, env: .env(l) 

sleep: suspend execution for an interval.sleep(l) 

sleep: suspend execution for interval.sleep(3C) 

monitor: prepare execution profile.monitor(3C) 

profil: execution time profile.profil(2) 

uux: unix to unix command execution.uux(lC) 

execvp: execute a J execl, execv, execle, execve, execlp, .exec(2) 

execute/ execl, execv, execle, execve, execlp, execvp:.exec(2) 

/execv, execle, execve, execlp, execvp: execute a file.exec(2) 

a new file or rewrite an existing one. creat: create.creat(2) 

process, exit, _exit: terminate.exit(2) 

exit, _exit: terminate process.exit(2) 

exponential intrinsic/ exp, dexp, cexp: Fortran.exp(3F) 

exponential, logarithm,/ exp, log, log 10, pow, sqrt:.exp(3M) 

peat, unpack: compress and expand files, pack,.pack(l) 

cmplx, dcmplx, ichar, char: explicit Fortran type/ /dble, .ftype(3F) 

exp, dexp, cexp: Fortran exponential intrinsic/.exp(3F) 

exp, log, log 10, pow, sqrt: exponential, logarithm, power,/.exp(3M) 

expression, expr: evaluate arguments as an.expr(l) 

routines, regexp: regular expression compile and match .regexp(5) 

regcmp: regular expression compile.regcmp(l) 

expr: evaluate arguments as an expression.expr(l) 

compile and execute regular expression, regcmp, regex: .regcmp(3X) 

efl: Extended Fortran Language.efl(l) 

greek: graphics for the extended TTY-37 type-box.greek(5) 

f77: Fortran 77 compiler.f77(l) 

fsplit: split f77, ratfor, or efl files.fsplit(l) 

remainder,/ floor, ceil, fmod, fabs: floor, ceiling,.floor(3M) 

factor: factor a number.factor(l) 

factor: factor a number.factor(l) 

true, false: provide truth values.true(l) 

data in a machine independent fashion., /access long numeric .sputl(3X) 

abort: generate an IOT fault.abort(3C) 

a stream, fclose, fflush: close or flush .fclose(3S) 

fcntl: file control.fcntl(2) 

fcntl: file control options.fcntl(5) 

floating-point number/ ecvt, fcvt, gcvt: convert.ecvt(3C) 

fopen, freopen, fdopen: open a stream.fopen(3S) 

status inquiries, ferror, feof, clearerr, fileno: stream .ferror(3S) 

fileno: stream status/ ferror, feof, clearerr, .ferror(3S) 
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Permuted Index 


stream, fclose, fflush: close or flush a.fclose(3S) 

files from the HONEYWELL/ fget, fget.demon: retrieve .fget(lC) 

word from/ getc, getchar, fgetc, getw: get character or .getc(3S) 

from the HONEYWELL/ fget, fget.demon: retrieve files .fget(lC) 

stream, gets, fgets: get a string from a.gets(3S) 

pattern, grep, egrep, fgrep: search a file for a.grep(l) 

times, utime: set file access and modification .utime(2) 

ldfcn: common object file access routines.ldfcn(4) 

determine accessibility of a file, access:.access(2) 

hpio: HP 2645A terminal tape file archiver.hpio(l) 

tar: tape file archiver.tar(l) 

cpio: copy file archives in and out.cpio(l) 

chmod: change mode of file.chmod(2) 

change owner and group of a file, chown: .chown(2) 

diff: differential file comparator.diff(l) 

diff3: 3-way differential file comparison.diff3(l) 

fcntl: file control.fcntl(2) 

fcntl: file control options.fcntl(5) 

uupick: public UNIX-to-UNIX file copy, uuto, .uuto(lC) 

core: format of core image file.core(4) 

cprs: compress an IS25 object file.cprs(l) 

umask: set and get file creation mask.umask(2) 

fields of each line of a file, cut: cut out selected .cut(l) 

dd: convert and copy a file.dd(l) 

a delta (change) to an SCCS file, delta: make.delta(l) 

close: close a file descriptor.close(2) 

dup: duplicate an open file descriptor.dup(2) 

file: determine file type.file(l) 

selected parts of an object file, dump: dump .dump(l) 

sact: print current SCCS file editing activity.sact(l) 

setgrent, endgrent: get group file entry, /getgmam,.getgrent(3C) 

endpwent: get password file entry, /setpwent,.getpwent(3C) 

utmpname: access utmp file entry, /endutent, .getut(3C) 

putpwent: write password file entry.putpwent(3C) 

exeelp, exeevp: execute a file, /exeev, execle, exeeve, .exec(2) 

grep, egrep, fgrep: search a file for a pattern.grep(l) 

ldaopen: open a common object file for reading, ldopen,.ldopen(3X) 

acct: per-process accounting file format.acct(4) 

ar: common archive file format.ar(4) 

ar: archive file format.ar.pdp(4) 

errfile: error-log file format.errfile(4) 

pnch: file format for card images.pnch(4) 

intro: introduction to file formats.intro(4) 

entries of a common object file function, /line number.ldlread(3X) 

get: get a version of an SCCS file.get(l) 

group: group file.group(4) 

files, filehdr: file header for common object .filehdr(4) 

file, ldfhread: read the file header of a common object.ldfhread(3X) 

ldohseek: seek to the optional file header of a common object/.ldohseek(3X) 

split: split a file into pieces.split(l) 

issue: issue identification file.issue(4) 

of a member of an archive file, /read the archive header.ldahread(3X) 

close a common object file, ldclose, ldaclose:.ldclose(3X) 

file header of a common object file, ldfhread: read the .ldfhread(3X) 

a section of a common object file, /line number entries of .ldlseek(3X) 

file header of a common object file, /seek to the optional .ldohseek(3X) 

a section of a common object file, /relocation entries of.ldrseek(3X) 

header of a common object file, /indexed/named section.ldshread(3X) 

section of a common object file, /to an indexed/named.ldsseek(3X) 

table entry of a common object file, /the index of a symbol .ldtbindex(3X) 

table entry of a common object file, /read an indexed symbol.ldtbread(3X) 

table of a common object file, /seek to the symbol.ldtbseek(3X) 

entries in a common object file, linenum: line number.linenum(4) 

link: link to a file.link(2) 

listing from 3B20S object file, list: produce C source.list(l) 

or a special or ordinary file, /make a directory, .mknod(2) 

ctermid: generate file name for terminal.ctermid(3S) 

mktemp: make a unique file name.mktemp(3C) 

change the format of a text file, newform:.newform(l) 

name list of common object file, nm: print.nm(l) 

/find the slot in the utmp file of the current user.ttyslot(3C) 

one. creat: create a new file or rewrite an existing .creat(2) 
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Permuted Index 


passwd: password file.passwd(4) 

or subsequent lines of one file./lines of several files .paste(l) 

/rewind, ftell: reposition a file pointer in a stream.fseek(3S) 

lseek: move read/write file pointer.lseek(2) 

prs: print an SCCS file.prs(l) 

read: read from file.read(2) 

for a common object file, /relocation information .reloc(4) 

remove a delta from an SCCS file, rmdel:.rmdel(l) 

bfs: big file scanner.bfs(l) 

two versions of an SCCS file, sccsdiff: compare .sccsdiff(l) 

sccsfile: format of SCCS file.sccsfile(4) 

header for a common object file, scnhdr: section .scnhdr(4) 

stat, fstat: get file status.stat(2) 

from a common object file./line number information .strip(l) 

checksum and block count of a file, sum: print .sum(l) 

syms: common object file symbol table format.syms(4) 

volume, file system: format of system.fs(4) 

mount: mount a file system.mount(2) 

ustat: get file system statistics.ustat(2) 

mnttab: mounted file system table.mnttab(4) 

umount: unmount a file system.umount(2) 

of 3B20S system description file, system: format .system(4) 

fsek. checklist: list of file systems processed by .checklist(4) 

deliver the last part of a file, tail:.tail(l) 

tmpfile: create a temporary file.tmpfile(3S) 

create a name for a temporary file, tmpnam, tempnam:.tmpnam(3S) 

and modification times of a file, touch: update access .touch(l) 

ftw: walk a file tree.ftw(3C) 

file: determine file type.file(l) 

undo a previous get of an SCCS file, unget:.unget(l) 

report repeated lines in a file, uniq: .uniq(l) 

val: validate SCCS file.val(l) 

write: write on a file.write(2) 

umask: set file-creation mode mask.umask(l) 

common object files, filehdr: file header for.filehdr(4) 

ferror, feof, clearerr, fileno: stream status/.ferror(3S) 

and print process accounting file(s). acctcom: search.acctcom(l) 

create and administer SCCS files, admin: .admin(l) 

send, gath: gather files and/or submit RJE jobs.send(lC) 

cat: concatenate and print files.cat(l) 

emp: compare two files.cmp(l) 

lines common to two sorted files, comm: select or reject .comm(l) 

cp. In, mv: copy, link or move files.cp(l) 

mark differences between files, diffmk:.diffmk(l) 

file header for common object files, filehdr: .filehdr(4) 

find: find files.find(l) 

archive/ arev: convert archive files from PDP-11 to common .arcv(l) 

fget, fget.demon: retrieve files from the HONEYWELL 6000.fget(lC) 

format specification in text files, fspec:.fspec(4) 

split f77, ratfor, or efl files, fsplit:.fsplit(l) 

string, format of graphical files, /graphical primitive .gps(4) 

link editor for common object files. Id:.ld( 1) 

scat: concatenate and print files on synchronous printer.scat(l) 

rm, rmdir: remove files or directories.rm(l) 

/merge same lines of several files or subsequent lines of/ .paste(l) 

unpack: compress and expand files, pack, peat,.pack(l) 

pr: print files.pr(l) 

section sizes of common object files, size: print.size(l) 

size: print sizes of object files.size.pdp(l) 

sort: sort and/or merge files.sort(l) 

NSC network, nusend: send files to another UNIX on the.nusend(lC) 

/convert object and archive files to common formats.convert(l) 

fsend: send files to the HONEYWELL 6000.fsend(lC) 

what: identify SCCS files.what(l) 

greek: select terminal filter.greek(l) 

nl: line numbering filter.nl( 1) 

col: filter reverse line-feeds.col(l) 

graphical device routines and filters./tekset, td: .gdev(lG) 

tplot: graphics filters.tplot(lG) 

find: find files.find(l) 

find: find files.find(l) 

hyphen: find hyphenated words.hyphen( 1) 
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Permuted Index 


ttyname, isatty: find name of a terminal.ttyname(3C) 

object library, lorder: find ordering relation for an .lorder(l) 

hashmake, spellin, hashcheck: find spelling errors, spell,.spell(l) 

of the current user, ttyslot: find the slot in the utmp file .ttyslot(3C) 

tee: pipe fitting.tee(l) 

int, ifix, idint, real, float, sngl, dble, cmplx,/.ftype(3F) 

atof: convert ASCII string to floating-point number.atof(3C) 

ecvt, fcvt, gcvt: convert floating-point number to/ .ecvt(3C) 

/modf: manipulate parts of floating-point numbers.frexp(3C) 

floor, ceiling, remainder,/ floor, ceil, fmod, fabs: .floor(3M) 

floor, ceil, fmod, fabs: floor, ceiling, remainder,/ .floor(3M) 

cflow: generate C flow graph.cflow(l) 

fclose, fflush: close or flush a stream.fclose(3S) 

remainder,/ floor, ceil, fmod, fabs: floor, ceiling, .floor(3M) 

stream, fopen, freopen, fdopen: open a.fopen(3S) 

fork: create a new process.fork(2) 

per-process accounting file format, acct: .acct(4) 

ar: common archive file format.ar(4) 

from PDP-11 to common archive format, /convert archive files.arcv(l) 

ar: archive file format.ar.pdp(4) 

errfile: error-log file format.errfile(4) 

pnch: file format for card images.pnch(4) 

nroff or/ eqn, neqn, checkeq: format mathematical text for.eqn(l) 

description file, system: format of 3B20S system.system(4) 

newform: change the format of a text file.newform(l) 

inode: format of an inode.inode(4) 

core: format of core image file.core(4) 

cpio: format of cpio archive.cpio(4) 

dir: format of directories.dir(4) 

/graphical primitive string, format of graphical files.gps(4) 

sccsfile: format of SCCS file.sccsfile(4) 

file system: format of system volume.fs(4) 

files, fspec: format specification in text.fspec(4) 

object file symbol table format, syms: common.syms(4) 

troff. tbl: format tables for nroff or .tbl(l) 

nroff: format text.nroff(l) 

and archive files to common formats, /convert object.convert(l) 

intro: introduction to file formats.intro(4) 

wtmp: utmp and wtmp entry formats, utmp, .utmp(4) 

scanf, fscanf, sscanf: convert formatted input.scanf(3S) 

fprintf, sprintf: print formatted output, printf,.printf(3S) 

/checkmm: print/check documents formatted with the MM macros.mm(l) 

mptx: the macro package for formatting a permuted index.mptx(5) 

mm: the MM macro package for formatting documents.mm(5) 

OSDD adapter macro package for formatting documents, /the .mosd(5) 

manual, man: macros for formatting entries in this.man(5) 

f77: Fortran 77 compiler.f77(l) 

abs, iabs, dabs, cabs, zabs: Fortran absolute value.abs(3F) 

system/ signal: specify Fortran action on receipt of a.signal(3F) 

function, acos, dacos: Fortran arccosine intrinsic.acos(3F) 

function, asin, dasin: Fortran arcsine intrinsic.asin(3F) 

function. atan2, datan2: Fortran arctangent intrinsic.atan2(3F) 

function, atan, datan: Fortran arctangent intrinsic.atan(3F) 

or, xor, not, lshift, rshift: Fortran bitwise boolean/ and,.bool(3F) 

getarg: return Fortran command-line argument.getarg(3F) 

log 10, aloglO, dloglO: Fortran common logarithm/ .logl0(3F) 

intrinsic/ conjg, dconjg: Fortran complex conjugate.conjg(3F) 

function, cos, dcos, ccos: Fortran cosine intrinsic.cos(3F) 

ratfor: rational Fortran dialect.ratfor(l) 

getenv: return Fortran environment variable.getenv(3F) 

function, exp, dexp, cexp: Fortran exponential intrinsic.exp(3F) 

intrinsic/ cosh, dcosh: Fortran hyperbolic cosine.cosh(3F) 

intrinsic/ sinh, dsinh: Fortran hyperbolic sine.sinh(3F) 

intrinsic/ tanh, dtanh: Fortran hyperbolic tangent.tanh(3F) 

complex/ aimag, dimag: Fortran imaginary part of .aimag(3F) 

function, aint, dint: Fortran integer part intrinsic.aint(3F) 

efl: Extended Fortran Language.efl(l) 

amaxO, maxi, amaxl, dmaxl: Fortran maximum-value//maxO, .max(3F) 

aminO, mini, aminl, dminl: Fortran minimum-value/ /minO,.min(3F) 

log, alog, dlog, clog: Fortran natural logarithm/.log(3F) 

anint, dnint, nint, idnint: Fortran nearest integer/.round(3F) 

abort: terminate Fortran program.abort(3F) 
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Permuted Index 


functions, mod, amod, dmod: Fortran remaindering intrinsic .mod(3F) 

function, sin, dsin, csin: Fortran sine intrinsic.sin(3F) 

function, sqrt, dsqrt, csqrt: Fortran square root intrinsic .sqrt(3F) 

len: return length of Fortran string.len(3F) 

index: return location of Fortran substring.index(3F) 

issue a shell command from Fortran, system:.system(3F) 

function, tan, dtan: Fortran tangent intrinsic.tan(3F) 

mclock: return Fortran time accounting.mclock(3F) 

intrinsic/ sign, isign, dsign: Fortran transfer-of-sign.sign(3F) 

/dcmplx, ichar, char: explicit Fortran type conversion.ftype(3F) 

generator, srand, rand: Fortran uniform random-number .rand(3F) 

formatted output, printf, fprintf, sprintf: print .printf(3S) 

word on a/ putc, putchar, fputc, putw: put character or.putc(3S) 

stream, puts, fputs: put a string on a .puts(3S) 

input/output, fread, fwrite: binary .fread(3S) 

memory allocator, malloc, free, realloc, calloc: main .malloc(3C) 

stream, fopen, freopen, fdopen: open a.fopen(3S) 

parts of floating-point/ frexp, ldexp, modf: manipulate.frexp(3C) 

list: produce C source listing from 3B20S object file.list(l) 

/and line number information from a common object file.strip(l) 

gets, fgets: get a string from a stream.gets(3S) 

rmdel: remove a delta from an SCCS file.rmdel(l) 

getopt: get option letter from argument vector.getopt(3C) 

read: read from file.read(2) 

system: issue a shell command from Fortran.system(3F) 

nlist: get entries from name list.nlist(3C) 

arcv: convert archive files from PDP-11 to common archive/.arcv(l) 

getw: get character or word from stream, /getchar, fgetc,.getc(3S) 

/fget.demon: retrieve files from the HONEYWELL 6000.fget(lC) 

nsctorje: re-route jobs from the NSC network to RJE.nsctorje(lC) 

getpw: get name from UID.getpw(3C) 

formatted input, scanf, fscanf, sscanf: convert .scanf(3S) 

of file systems processed by fsck. checklist: list.checklist(4) 

reposition a file pointer in/ fseek, rewind, ftell:.fseek(3S) 

HONEYWELL 6000. fsend: send files to the .fsend(lC) 

text files, fspec: format specification in.fspec(4) 

efl files, fsplit: split f77, ratfor, or .fsplit(l) 

stat, fstat: get file status.stat(2) 

pointer in a/ fseek, rewind, ftell: reposition a file.fseek(3S) 

ftw: walk a file tree.ftw(3C) 

Fortran arccosine intrinsic function, acos, dacos:.acos(3F) 

Fortran integer part intrinsic function, aint, dint:.aint(3F) 

error/ erf, erfc: error function and complementary.erf(3M) 

Fortran arcsine intrinsic function, asin, dasin:.asin(3F) 

Fortran arctangent intrinsic function. atan2, datan2:.atan2(3F) 

Fortran arctangent intrinsic function, atan, datan:.atan(3F) 

complex conjugate intrinsic function, /dconjg: Fortran.conjg(3F) 

ccos: Fortran cosine intrinsic function, cos, dcos, .cos(3F) 

hyperbolic cosine intrinsic function, /dcosh: Fortran .cosh(3F) 

and complementary error function, /error function.erf(3M) 

Fortran exponential intrinsic function, exp, dexp, cexp:.exp(3F) 

gamma: log gamma function.gamma(3M) 

hypot: Euclidean distance function.hypot(3M) 

of a common object file function, /line number entries .ldlread(3X) 

common logarithm intrinsic function./dlog 10: Fortran.logl0(3F) 

natural logarithm intrinsic function, /dlog, clog: Fortran.log(3F) 

matherr: error-handling function.matherr(3M) 

transfer-of-sign intrinsic function, /dsign: Fortran .sign(3F) 

csin: Fortran sine intrinsic function, sin, dsin,.sin(3F) 

hyperbolic sine intrinsic function, /dsinh: Fortran .sinh(3F) 

Fortran square root intrinsic function, sqrt, dsqrt, csqrt:.sqrt(3F) 

Fortran tangent intrinsic function, tan, dtan:.tan(3F) 

hyperbolic tangent intrinsic function, /dtanh: Fortran .tanh(3F) 

jO, j 1, jn, yO, yl, yn: Bessel functions.bessel(3M) 

Fortran bitwise boolean functions, /lshift, rshift:.bool(3F) 

logarithm, power, square root functions, /sqrt: exponential,.exp(3M) 

remainder, absolute value functions, /floor, ceiling, .floor(3M) 

dmaxl: Fortran maximum-value functions./maxi, amaxl,.max(3F) 

dminl: Fortran minimum-value functions./mini, aminl, .min(3F) 

Fortran remaindering intrinsic functions, mod, amod, dmod: .mod(3F) 

300, 300s: handle special functions of DASI 300 and 300s/. 300(1) 

hp: handle special functions of HP 2640 and/.hp( 1) 
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Permuted Index 


terminal. 450: handle special functions of the DASI450 . 450(1) 

Fortran nearest integer functions, /nint, idnint:.round(3F) 

sinh, cosh, tanh: hyperbolic functions.sinh(3M) 

atan, atan2: trigonometric functions, /tan, asin, acos,.trig(3M) 

fread, fwrite: binary input/output.fread(3S) 

jotto: secret word game.jotto(6) 

moo: guessing game.moo(6) 

back: the game of backgammon.back(6) 

bj: the game of black jack.bj(6) 

chess: the game of chess.chess(6) 

craps: the game of craps.craps(6) 

reversi: a game of dramatic reversals.reversi(6) 

wump: the game of hunt-the-wumpus.wump(6) 

intro: introduction to games.intro(6) 

gamma: log gamma function.gamma(3M) 

gamma: log gamma function.gamma(3M) 

submit RJE jobs, send, gath: gather files and/or.send(lC) 

jobs, send, gath: gather files and/or submit RJE .send(lC) 

output to the HONEYWELL 6000. gcat: send phototypesetter.gcat(lC) 

user, gcosmail: send mail to HIS .gcosmail(lC) 

number to string, ecvt, fcvt, gcvt: convert floating-point .ecvt(3C) 

ged: graphical editor.ged(lG) 

maze: generate a maze.maze(6) 

abort: generate an IOT fault.abort(3C) 

cflow: generate C flow graph.cflow(l) 

reference, cxref: generate C program cross .cxref(l) 

crypt, setkey, encrypt: generate DES encryption.crypt(3C) 

makekey: generate encryption key.makekey(l) 

terminal, ctermid: generate file name for.ctermid(3S) 

lexical tasks, lex: generate programs for simple.lex(l) 

/srand48, seed48, lcong48: generate uniformly distributed/.drand48(3C) 

srand: simple random-number generator, rand,.rand(3C) 

Fortran uniform random-number generator, srand, rand: .rand(3F) 

gets, fgets: get a string from a stream.gets(3S) 

get: get a version of an SCCS file.get(l) 

ulimit: get and set user limits.ulimit(2) 

the user, cuserid: get character login name of .cuserid(3S) 

getc, getchar, fgetc, getw: get character or word from/ .getc(3S) 

nlist: get entries from name list.nlist(3C) 

umask: set and get file creation mask.umask(2) 

stat, fstat: get file status.stat(2) 

ustat: get file system statistics.ustat(2) 

file, get: get a version of an SCCS.get(l) 

/getgmam, setgrent, endgrent: get group file entry.getgrent(3C) 

getlogin: get login name.getlogin(3C) 

logname: get login name.logname(l) 

msgget: get message queue.msgget(2) 

getpw: get name from UID.getpw(3C) 

system, uname: get name of current UNIX.uname(2) 

unget: undo a previous get of an SCCS file.unget(l) 

argument vector, getopt: get option letter from.getopt(3C) 

/getpwnam, setpwent, endpwent: get password file entry.getpwent(3C) 

working directory, getcwd: get path-name of current.getcwd(3C) 

times, times: get process and child process.times(2) 

and/ getpid, getpgrp, getppid: get process, process group,.getpid(2) 

/geteuid, getgid, getegid: get real user, effective user,/.getuid(2) 

semget: get set of semaphores.semget(2) 

shmget: get shared memory segment.shmget(2) 

tty: get the terminal’s name.tty(1) 

time: get time.time(2) 

command-line argument, getarg: return Fortran.getarg(3F) 

get character or word from/ getc, getchar, fgetc, getw:.getc(3S) 

character or word from/ getc, getchar, fgetc, getw: get.getc(3S) 

current working directory, getcwd: get path-name of.getcwd(3C) 

getuid, geteuid, getgid, getegid: get real user,/.getuid(2) 

environment variable, getenv: return Fortran.getenv(3F) 

environment name, getenv: return value for.getenv(3C) 

real user, effective/ getuid, geteuid, getgid, getegid: get .getuid(2) 

user,/ getuid, geteuid, getgid, getegid: get real.getuid(2) 

setgrent, endgrent: get group/ getgrent, getgrgid, getgmam,.getgrent(3C) 

endgrent: get group/ getgrent, getgrgid, getgmam, setgrent,.getgrent(3C) 

get group/ getgrent, getgrgid, getgmam, setgrent, endgrent:.getgrent(3C) 
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Permuted Index 


getlogin: get login name.getlogin(3C) 

argument vector, getopt: get option letter from.getopt(3C) 

getopt: parse command options.getopt(l) 

getpass: read a password.getpass(3C) 

process group, and/ getpid, getpgrp, getppid: get process,.getpid(2) 

process, process group, and/ getpid, getpgrp, getppid: get.getpid(2) 

group, and/ getpid, getpgrp, getppid: get process, process.getpid(2) 

getpw: get name from UID.getpw(3C) 

setpwent, endpwent: get/ getpwent, getpwuid, getpwnam,.getpwent(3C) 

get/ getpwent, getpwuid, getpwnam, setpwent, endpwent: .getpwent(3C) 

endpwent: get/ getpwent, getpwuid, getpwnam, setpwent,.getpwent(3C) 

a stream, gets, fgets: get a string from .gets(3S) 

and terminal settings used by getty. gettydefs: speed .gettydefs(4) 

ct: spawn getty to a remote terminal.ct(lC) 

settings used by getty. gettydefs: speed and terminal.gettydefs(4) 

getegid: get real user,/ getuid, geteuid, getgid, .getuid(2) 

pututline, setutent,/ getutent, getutid, getutline,.getut(3C) 

setutent, endutent,/ getutent, getutid, getutline, pututline, .getut(3C) 

setutent,/ getutent, getutid, getutline, pututline,.getut(3C) 

from/ getc, getchar, fgetc, getw: get character or word .getc(3S) 

convert/ ctime, localtime, gmtime, asctime, tzset: .ctime(3C) 

setjmp, longjmp: non-local goto.setjmp(3C) 

string, format of graphical/ gps: graphical primitive.gps(4) 

cflow: generate C flow graph.cflow(l) 

graph: draw a graph.graph(lG) 

graph: draw a graph.graph(lG) 

sag: system activity graph.sag(lG) 

commands, graphics: access graphical and numerical.graphics(lG) 

/network useful with graphical commands.stat(lG) 

/erase, hardcopy, tekset, td: graphical device routines and/ .gdev(lG) 

ged: graphical editor.ged(lG) 

primitive string, format of graphical files, /graphical.gps(4) 

format of graphical/ gps: graphical primitive string,.gps(4) 

routines, toe: graphical table of contents.toc(lG) 

gutil: graphical utilities.gutil(lG) 

numerical commands, graphics: access graphical and .graphics(lG) 

tplot: graphics filters.tplot(lG) 

TTY-37 type-box. greek: graphics for the extended .greek(5) 

plot: graphics interface.plot(4) 

subroutines, plot: graphics interface .plot(3X) 

mvt: typeset documents, view graphs, and slides, mmt, .mmt(l) 

package for typesetting view graphs and slides, /macro.mv(5) 

extended TTY-37 type-box. greek: graphics for the .greek(5) 

greek: select terminal filter.greek(l) 

file for a pattern, grep, egrep, fgrep: search a.grep(l) 

/user, effective user, real group, and effective group/.getuid(2) 

/getppid: get process, process group, and parent process IDs.getpid(2) 

chown, chgrp: change owner or group.chown(l) 

setgrent, endgrent: get group file entry, /getgmam, .getgrent(3C) 

group: group file.group(4) 

group: group file.group(4) 

setpgrp: set process group ID.setpgrp(2) 

id: print user and group IDs and names.id( 1) 

real group, and effective group IDs. /effective user,.getuid(2) 

setuid, setgid: set user and group IDs.setuid(2) 

newgrp: log in to a new group.newgrp(l) 

chown: change owner and group of a file.chown(2) 

a signal to a process or a group of processes, /send.kill(2) 

update, and regenerate groups of programs./maintain,.make(l) 

ssignal, gsignal: software signals.ssignal(3C) 

hangman: guess the word.hangman(6) 

moo: guessing game.moo(6) 

gutil: graphical utilities.gutil(lG) 

x25hlnk, x25dlnk: halt or detach a BX.25 link.x25hlnk(3C) 

DASI 300 and 300s/ 300, 300s: handle special functions of. 300(1) 

2640 and 2621 -series/ hp: handle special functions of HP.hp(l) 

the DASI 450 terminal. 450: handle special functions of. 450(1) 

hangman: guess the word.hangman(6) 

nohup: run a command immune to hangups and quits.nohup(l) 

graphical device/hpd, erase, hardcopy, tekset, td: .gdev(lG) 

hcreate, hdestroy: manage hash search tables, hsearch, .hsearch(3C) 

spell, hashmake, spellin, hashcheck: find spelling/ .spell(l) 
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Permuted Index 


find spelling errors, spell, hashmake, spellin, hashcheck: .spell(l) 

search tables, hsearch, hcreate, hdestroy: manage hash.hsearch(3C) 

tables, hsearch, hcreate, hdestroy: manage hash search .hsearch(3C) 

file, scnhdr: section header for a common object .scnhdr(4) 

files, filehdr: file header for common object.filehdr(4) 

file, ldfhread: read the file header of a common object.ldfhread(3X) 

/seek to the optional file header of a common object/ .ldohseek(3X) 

/read an indexed/named section header of a common object/ .ldshread(3X) 

ldahread: read the archive header of a member of an/.ldahread(3X) 

help: ask for help.help( 1) 

help: ask for help.help(l) 

retrieve files from the HONEYWELL 6000./fget.demon: .fget(lC) 

fsend: send files to the HONEYWELL 6000.fsend(lC) 

phototypesetter output to the HONEYWELL 6000. gcat: send.gcat(lC) 

printer daemon, dpd, lpd: HONEYWELL sending daemon, line .dpd(lC) 

handle special functions of HP 2640 and 2621-series/ hp: .hp( 1) 

archiver, hpio: HP 2645A terminal tape file.hpio(l) 

of HP 2640 and 2621-series/ hp: handle special functions .hp(l) 

td: graphical device routines/ hpd, erase, hardcopy, tekset,.gdev(lG) 

file archiver, hpio: HP 2645A terminal tape .hpio(l) 

manage hash search tables, hsearch, hcreate, hdestroy:.hsearch(3C) 

wump: the game of hunt-the-wumpus.wump(6) 

cosh, dcosh: Fortran hyperbolic cosine intrinsic/.cosh(3F) 

sinh, cosh, tanh: hyperbolic functions.sinh(3M) 

sinh, dsinh: Fortran hyperbolic sine intrinsic/ .sinh(3F) 

tanh, dtanh: Fortran hyperbolic tangent intrinsic/.tanh(3F) 

hyphen: find hyphenated words.hyphen(l) 

hyphen: find hyphenated words.hyphen(l) 

function, hypot: Euclidean distance.hypot(3M) 

Fortran absolute value, abs, iabs, dabs, cabs, zabs:.abs(3F) 

/sngl, dble, cmplx, dcmplx, ichar, char: explicit Fortran/ .ftype(3F) 

semaphore set or shared memory id. /remove a message queue, .ipcrm(l) 

and names, id: print user and group IDs .id( 1) 

setpgrp: set process group ID.setpgrp(2) 

issue: issue identification file.issue(4) 

what: identify SCCS files.what(l) 

dble, cmplx,/ int, ifix, idint, real, float, sngl,.ftype(3F) 

integer/ anint, dnint, nint, idnint: Fortran nearest.round(3F) 

id: print user and group IDs and names.id(l) 

group, and parent process IDs. /get process, process.getpid(2) 

group, and effective group IDs. /effective user, real.getuid(2) 

setgid: set user and group IDs. setuid,.setuid(2) 

sngl, dble, cmplx,/ int, ifix, idint, real, float, .ftype(3F) 

core: format of core image file.core(4) 

pnch: file format for card images.pnch(4) 

aimag, dimag: Fortran imaginary part of complex/ .aimag(3F) 

nohup: run a command immune to hangups and quits.nohup(l) 

long numeric data in a machine independent fashion., /access.sputl(3X) 

for formatting a permuted index, /the macro package.mptx(5) 

of a/ ldtbindex: compute the index of a symbol table entry.ldtbindex(3X) 

ptx: permuted index.ptx(l) 

Fortran substring, index: return location of.index(3F) 

a common/ ldtbread: read an indexed symbol table entry of .ldtbread(3X) 

ldshread, ldnshread: read an indexed/named section header/.ldshread(3X) 

ldsseek, ldnsseek: seek to an indexed/named section of a/.ldsseek(3X) 

inittab: script for the init process.inittab(4) 

process, popen, pclose: initiate pipe to/from a.popen(3S) 

process, inittab: script for the init.inittab(4) 

inode: format of an inode.inode(4) 

inode: format of an inode.inode(4) 

sscanf: convert formatted input, scanf, fscanf, .scanf(3S) 

push character back into input stream, ungetc:.ungetc(3S) 

fread, fwrite: binary input/output.fread(3S) 

stdio: standard buffered input/output package.stdio(3S) 

fileno: stream status inquiries, /feof, clearerr,.ferror(3S) 

uustat: uucp status inquiry and job control.uustat(lC) 

x25alnk, x25ilnk: attach or install a BX.25 link.x25alnk(3C) 

link. x25ipvc, x25rpvc: install or remove a PVC on a.x25ipvc(3C) 

sngl, dble, cmplx, dcmplx,/ int, ifix, idint, real, float,.ftype(3F) 

abs: return integer absolute value.abs(3C) 

/164a: convert between long integer and base-64 ASCII/ .a641(3C) 

nint, idnint: Fortran nearest integer functions, /dnint, .round(3F) 
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Permuted Index 


function, aint, dint: Fortran integer part intrinsic .aint(3F) 

atol, atoi: convert string to integer, strtol,.strtol(3C) 

/ltol3: convert between 3-byte integers and long integers.13tol(3C) 

3-byte integers and long integers, /convert between.13tol(3C) 

rjestat: RJE status report and interactive status console.rjestat(lC) 

plot: graphics interface.plot(4) 

plot: graphics interface subroutines.plot(3X) 

spline: interpolate smooth curve.spline(lG) 

characters, asa: interpret ASA carriage control .asa(l) 

sno: SNOBOL interpreter.sno(l) 

pipe: create an interprocess channel.pipe(2) 

facilities/ipcs: report inter-process communication.ipcs(l) 

package, stdipc: standard interprocess communication.stdipc(3C) 

suspend execution for an interval, sleep: .sleep(l) 

sleep: suspend execution for interval.sleep(3C) 

acos, dacos: Fortran arccosine intrinsic function.acos(3F) 

dint: Fortran integer part intrinsic function, aint,.aint(3F) 

asin, dasin: Fortran arcsine intrinsic function.asin(3F) 

datan2: Fortran arctangent intrinsic function. atan2, .atan2(3F) 

datan: Fortran arctangent intrinsic function, atan,.atan(3F) 

Fortran complex conjugate intrinsic function, /dconjg:.conjg(3F) 

dcos, ccos: Fortran cosine intrinsic function, cos, .cos(3F) 

Fortran hyperbolic cosine intrinsic function, /dcosh:.cosh(3F) 

cexp: Fortran exponential intrinsic function, /dexp, .exp(3F) 

Fortran common logarithm intrinsic function./dlog 10:.logl0(3F) 

Fortran natural logarithm intrinsic function, /clog:.log(3F) 

Fortran transfer-of-sign intrinsic function./dsign: .sign(3F) 

sin, dsin, csin: Fortran sine intrinsic function.sin(3F) 

dsinh: Fortran hyperbolic sine intrinsic function, sinh,.sinh(3F) 

csqrt: Fortran square root intrinsic function, /dsqrt, .sqrt(3F) 

tan, dtan: Fortran tangent intrinsic function.tan(3F) 

Fortran hyperbolic tangent intrinsic function, /dtanh: .tanh(3F) 

dmod: Fortran remaindering intrinsic functions, /amod,.mod(3F) 

commands and application/ intro: introduction to.intro(l) 

formats, intro: introduction to file.intro(4) 

intro: introduction to games.intro(6) 

miscellany, intro: introduction to.intro(5) 

subroutines and libraries, intro: introduction to.intro(3) 

calls and error numbers, intro: introduction to system.intro(2) 

application programs, intro: introduction to commands and .intro(l) 

intro: introduction to file formats.intro(4) 

intro: introduction to games.intro(6) 

intro: introduction to miscellany.intro(5) 

and libraries, intro: introduction to subroutines.intro(3) 

and error numbers, intro: introduction to system calls .intro(2) 

ioctl: control device.ioctl(2) 

abort: generate an IOT fault.abort(3C) 

semaphore set or shared/ ipcrm: remove a message queue, .ipcrm(l) 

communication facilities/ ipcs: report inter-process .ipcs(l) 

cprs: compress an IS25 object file.cprs(l) 

/islower, isdigit, isxdigit, isalnum, isspace, ispunct,/.ctype(3C) 

isdigit, isxdigit, isalnum,/ isalpha, isupper, islower, .ctype(3C) 

/isprint, isgraph, iscntrl, isascii: classify characters.ctype(3C) 

terminal, ttyname, isatty: find name of a.ttyname(3C) 

/ispunct, isprint, isgraph, iscntrl, isascii: classify/.ctype(3C) 

isalpha, isupper, islower, isdigit, isxdigit, isalnum,/.ctype(3C) 

/isspace, ispunct, isprint, isgraph, iscntrl, isascii:/.ctype(3C) 

transfer-of-sign/ sign, isign, dsign: Fortran .sign(3F) 

isalnum,/ isalpha, isupper, islower, isdigit, isxdigit,.ctype(3C) 

/isalnum, isspace, ispunct, isprint, isgraph, iscntrl,/.ctype(3C) 

/isxdigit, isalnum, isspace, ispunct, isprint, isgraph,/ .ctype(3C) 

/isdigit, isxdigit, isalnum, isspace, ispunct, isprint,/.ctype(3C) 

Fortran, system: issue a shell command from .system(3F) 

system: issue a shell command.system(3S) 

issue: issue identification file.issue(4) 

file, issue: issue identification .issue(4) 

isxdigit, isalnum,/ isalpha, isupper, islower, isdigit,.ctype(3C) 

/isupper, islower, isdigit, isxdigit, isalnum, isspace,/.ctype(3C) 

news: print news items.news(l) 

functions. jO, j 1, jn, yO, yl, yn: Bessel .bessel(3M) 

functions. jO, jl, jn, yO, yl, yn: Bessel.bessel(3M) 

bj: the game of black jack.bj(6) 
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Permuted Index 


functions. jO, j 1, jn, yO, yl, yn: Bessel.bessel(3M) 

operator, join: relational database.join(l) 

jotto: secret word game.jotto(6) 

/lrand48, nrand48, mrand48, jrand48, srand48, seed48,/.drand48(3C) 

assembler/un-assembler for/ kasb, kunb:.kasb(l) 

makekey: generate encryption key.makekey(l) 

process or a group of/ kill: send a signal to a.kill(2) 

kill: terminate a process.kill(l) 

/assembler/un-assembler for the KMC 11B microprocessor.kasb( 1) 

quiz: test your knowledge.quiz(6) 

for the KMC 1 IB/kasb, kunb: assembler/un-assembler .kasb(l) 

3-byte integers and long/ 13tol, ltol3: convert between.13tol(3C) 

integer and base-64/ a641, 164a: convert between long.a641(3C) 

scanning and processing language, awk: pattern.awk(l) 

arbitrary-precision arithmetic language, be:.bc(l) 

efl: Extended Fortran Language.efl(l) 

epp: the C language preprocessor.cpp(l) 

command programming language, /standard/restricted .sh(l) 

/jrand48, srand48, seed48, lcong48: generate uniformly/.drand48(3C) 

object files. Id: link editor for common.ld(l) 

Id: link editor.ld.pdp(l) 

object file, ldclose, ldaclose: close a common.ldclose(3X) 

header of a member of an/ ldahread: read the archive.ldahread(3X) 

file for reading, ldopen, ldaopen: open a common object.ldopen(3X) 

common object file, ldclose, ldaclose: close a.ldclose(3X) 

of floating-point/ frexp, ldexp, modf: manipulate parts .frexp(3C) 

access routines, ldfcn: common object file.ldfcn(4) 

of a common object file, ldfhread: read the file header.ldfhread(3X) 

line number entries/ ldlread, ldlinit, ldlitem: manipulate.ldlread(3X) 

number/ ldlread, ldlinit, ldlitem: manipulate line.ldlread(3X) 

manipulate line number/ ldlread, ldlinit, ldlitem: .ldlread(3X) 

number entries of a section/ ldlseek,ldnlseek: seek to line.ldlseek(3X) 

entries of a section/ ldrseek, ldnrseek: seek to relocation .ldrseek(3X) 

indexed/named/ ldshread, ldnshread: read an.ldshread(3X) 

indexed/named/ ldsseek, ldnsseek: seek to an .ldsseek(3X) 

file header of a common/ ldohseek: seek to the optional.ldohseek(3X) 

object file for reading, ldopen, ldaopen: open a common.ldopen(3X) 

relocation entries of a/ ldrseek, ldnrseek: seek to .ldrseek(3X) 

indexed/named section header/ ldshread, ldnshread: read an .ldshread(3X) 

indexed/named section of a/ ldsseek, ldnsseek: seek to an.ldsseek(3X) 

of a symbol table entry of a/ ldtbindex: compute the index.ldtbindex(3X) 

symbol table entry of a/ ldtbread: read an indexed .ldtbread(3X) 

table of a common object/ ldtbseek: seek to the symbol.ldtbseek(3X) 

string, len: return length of Fortran .len(3F) 

len: return length of Fortran string.len(3F) 

getopt: get option letter from argument vector.getopt(3C) 

simple lexical tasks, lex: generate programs for.lex(l) 

generate programs for simple lexical tasks, lex: .lex(l) 

to subroutines and libraries, /introduction .intro(3) 

relation for an object library, /find ordering.lorder(l) 

ar: archive and library maintainer.ar.pdp(l) 

portable/ar: archive and library maintainer for.ar(l) 

ulimit: get and set user limits.ulimit(2) 

an out-going terminal line connection, /establish.dial(3C) 

line: read one line.line(l) 

common object file, linenum: line number entries in a.linenum(4) 

/ldlinit, ldlitem: manipulate line number entries of a/.ldlread(3X) 

ldlseek,ldnlseek: seek to line number entries of a/.ldlseek(3X) 

strip: strip symbol and line number information from a J .strip(l) 

nl: line numbering filter.nl(l) 

out selected fields of each line of a file, cut: cut.cut(l) 

lpd: HONEYWELL sending daemon, line printer daemon, dpd, .dpd(lC) 

send/cancel requests to an LP line printer. Ip, cancel: .lp( 1) 

lpr: line printer spooler.lpr(l) 

line: read one line.line(l) 

lsearch: linear search and update.lsearch(3C) 

col: filter reverse line-feeds.col(l) 

in a common object file, linenum: line number entries.linenum(4) 

files, comm: select or reject lines common to two sorted .comm(l) 

uniq: report repeated lines in a file.uniq(l) 

of several files or subsequent lines of one file, /same lines.paste(l) 

subsequent/paste: merge same lines of several files or .paste(l) 
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Permuted Index 


files. Id: link editor for common object .ld( 1) 

Id: link editor.ld.pdp(l) 

a.out: common assembler and link editor output.a.out(4) 

a.out: PDP-11 assembler and link editor output.a.out.pdp(4) 

link: link to a file.link(2) 

cp. In, mv: copy, link or move files.cp(l) 

link: link to a file.link(2) 

attach or install a BX.25 link. x25alnk, x25ilnk:.x25alnk(3C) 

x25clnk: change over a BX.25 link.x25clnk(3C) 

halt or detach a BX.25 link. x25hlnk, x25dlnk:.x25hlnk(3C) 

install or remove a PVC on a link. x25ipvc, x25rpvc:.x25ipvc(3C) 

lint: a C program checker.lint(l) 

Is: list contents of directories.ls(l) 

nlist: get entries from name list.nlist(3C) 

nm: print name list.nm.pdp(l) 

nm: print name list of common object file.nm(l) 

by fsck. checklist: list of file systems processed.checklist(4) 

from 3B20S object file, list: produce C source listing.list(l) 

file, list: produce C source listing from 3B20S object.list(l) 

xargs: construct argument list(s) and execute command.xargs(l) 

files, cp, In, mv: copy, link or move.cp(l) 

tzset: convert date/ ctime, localtime, gmtime, asctime, .ctime(3C) 

index: return location of Fortran substring.index(3F) 

end, etext, edata: last locations in program.end(3C) 

memory, plock: lock process, text, or data in .plock(2) 

trouble: log a trouble report.trouble(l) 

natural logarithm intrinsic/ log, alog, dlog, clog: Fortran.log(3F) 

gamma: log gamma function.gamma(3M) 

newgrp: log in to a new group.newgrp(l) 

exponential, logarithm,/exp, log, log 10, pow, sqrt:.exp(3M) 

common logarithm intrinsic/ log 10, alog 10, dlog 10: Fortran.logl0(3F) 

logarithm, power,/exp, log, log 10, pow, sqrt: exponential, .exp(3M) 

/alog 10, dlog 10: Fortran common logarithm intrinsic function.logl0(3F) 

/dlog, clog: Fortran natural logarithm intrinsic function.log(3F) 

/log 10, pow, sqrt: exponential, logarithm, power, square root/ .exp(3M) 

getlogin: get login name.getlogin(3C) 

logname: get login name.logname(l) 

cuserid: get character login name of the user.cuserid(3S) 

logname: return login name of user.logname(3X) 

passwd: change login password.passwd(l) 

login: sign on.login(l) 

setting up an environment at login time, profile:.profile(4) 

logname: get login name.logname( 1) 

user, logname: return login name of .logname(3X) 

a641,164a: convert between long integer and base-64 ASCII/ .a641(3C) 

between 3-byte integers and long integers./ltol3: convert.13tol(3C) 

sputl, sgetl: access long numeric data in a machine/.sputl(3X) 

setjmp, longjmp: non-local goto.setjmp(3C) 

for an object library, lorder: find ordering relation.lorder(l) 

nice: run a command at low priority.nice(l) 

requests to an LP line/ lp, cancel: send/cancel .lp( 1) 

send/cancel requests to an LP line printer, lp, cancel:.lp( 1) 

disable: enable/disable LP printers, enable, .enable(l) 

lpstat: print LP status information.lpstat(l) 

line printer daemon, dpd, lpd: HONEYWELL sending daemon, .dpd(lC) 

lpr: line printer spooler.lpr(l) 

information, lpstat: print LP status.lpstat(l) 

jrand48,/ drand48, erand48, lrand48, nrand48, mrand48, .drand48(3C) 

directories. Is: list contents of .ls(l) 

update, lsearch: linear search and .lsearch(3C) 

pointer, lseek: move read/write file.lseek(2) 

bitwise/ and, or, xor, not, lshift, rshift: Fortran .bool(3F) 

integers and long/ 13tol, ltol3: convert between 3-byte.13tol(3C) 

m4: macro processor.m4(l) 

/access long numeric data in a machine independent fashion.sputl(3X) 

permuted index, mptx: the macro package for formatting a.mptx(5) 

documents, mm: the MM macro package for formatting.mm(5) 

mosd: the OSDD adapter macro package for formatting/ .mosd(5) 

view graphs and/ mv: a troff macro package for typesetting .mv(5) 

m4: macro processor.m4(l) 

in this manual, man: macros for formatting entries.man(5) 

formatted with the MM macros./print/check documents.mm(l) 
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Permuted Index 


send mail to users or read mail, mail, rmail: .mail(l) 

users or read mail, mail, rmail: send mail to.mail(l) 

gcosmail: send mail to HIS user.gcosmail(lC) 

mail, rmail: send mail to users or read mail.mail(l) 

malloc, free, realloc, calloc: main memory allocator.malloc(3C) 

regenerate groups of/make: maintain, update, and.make(l) 

ar: archive and library maintainer.ar.pdp(l) 

ar: archive and library maintainer for portable/.ar(l) 

SCCS file, delta: make a delta (change) to an .delta(l) 

mkdir: make a directory.mkdir( 1) 

or ordinary file, mknod: make a directory, or a special.mknod(2) 

mktemp: make a unique file name.mktemp(3C) 

regenerate groups of/ make: maintain, update, and.make(l) 

banner: make posters.banner(l) 

key. makekey: generate encryption .makekey(l) 

main memory allocator, malloc, free, realloc, calloc: .malloc(3C) 

entries in this manual, man: macros for formatting .man(5) 

this manual, man, manprog: print entries in .man(l) 

tsearch, tdelete, twalk: manage binary search trees.tsearch(3C) 

hsearch, hcreate, hdestroy: manage hash search tables.hsearch(3C) 

of/ ldlread, ldlinit, ldlitem: manipulate line number entries.ldlread(3X) 

frexp, ldexp, modf: manipulate parts of/ .frexp(3C) 

manual, man, manprog: print entries in this.man(l) 

manprog: print entries in this manual, man,.man(l) 

for formatting entries in this manual, man: macros.man(5) 

ascii: map of ASCII character set.ascii(5) 

files, diffmk: mark differences between.diffmk(l) 

umask: set file-creation mode mask.umask(l) 

set and get file creation mask, umask:.umask(2) 

table, master: master device information.master.dec(4) 

table, master: master device information.master.u3b(4) 

information table, master: master device.master.dec(4) 

information table, master: master device.master.u3b(4) 

regular expression compile and match routines, regexp:.regexp(5) 

eqn, neqn, checkeq: format mathematical text for nroff or/ .eqn(l) 

function, matherr: error-handling.matherr(3M) 

multiple-access-user-space/ maus:.maus(2) 

dmaxl: Fortran maximum-value/ max, maxO, amaxO, maxi, amaxl,.max(3F) 

dmaxl: Fortran/max, maxO, amaxO, maxi, amaxl,.max(3F) 

max, maxO, amaxO, maxi, amaxl, dmaxl: Fortran/.max(3F) 

/maxi, amaxl, dmaxl: Fortran maximum-value functions.max(3F) 

maze: generate a maze.maze(6) 

maze: generate a maze.maze(6) 

accounting, mclock: return Fortran time .mclock(3F) 

memepy, memset: memory/ memccpy, memchr, mememp, .memory(3C) 

memset: memory/ memccpy, memchr, mememp, memepy,.memory(3C) 

operations, memccpy, memchr, mememp, memepy, memset: memory .memory(3C) 

memccpy, memchr, mememp, memepy, memset: memory/ .memory(3C) 

free, realloc, calloc: main memory allocator, malloc,.malloc(3C) 

shmctl: shared memory control operations.shmctl(2) 

queue, semaphore set or shared memory id./remove a message.ipcrm(l) 

/(shared memory) operations.maus(2) 

mememp, memepy, memset: memory operations, /memchr, .memory(3C) 

shmop: shared memory operations.shmop(2) 

lock process, text, or data in memory, plock:.plock(2) 

shmget: get shared memory segment.shmget(2) 

/memchr, mememp, memepy, memset: memory operations.memory(3C) 

sort: sort and/or merge files.sort(l) 

files or subsequent/paste: merge same lines of several .paste(l) 

mesg: permit or deny messages.mesg(l) 

msgctl: message control operations.msgctl(2) 

msgop: message operations.msgop(2) 

msgget: get message queue.msgget(2) 

or shared/ iperm: remove a message queue, semaphore set .ipcrm(l) 

mesg: permit or deny messages.mesg(l) 

sys_nerr: system error messages, /ermo, sys_errlist,.perror(3C) 

/for the KMC1 IB microprocessor.kasb(l) 

dminl: Fortran minimum-value/ min, minO, aminO, mini, aminl, .min(3F) 

dminl: Fortran/min, minO, aminO, mini, aminl,.min(3F) 

min, minO, aminO, mini, aminl, dminl: Fortran/.min(3F) 

/mini, aminl, dminl: Fortran minimum-value functions.min(3F) 

mkdir: make a directory.mkdir( 1) 
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Permuted Index 


special or ordinary file, mknod: make a directory, or a .mknod(2) 

name, mktemp: make a unique file .mktemp(3C) 

formatting documents, mm: the MM macro package for.mm(5) 

documents formatted with the MM macros./print/check.mm(l) 

documents formatted with the/ mm, osdd, checkmm: print/check.mm(l) 

formatting documents, mm: the MM macro package for .mm(5) 

view graphs, and slides, mmt, mvt: typeset documents, .mmt(l) 

table, mnttab: mounted file system.mnttab(4) 

remaindering intrinsic/ mod, amod, dmod: Fortran.mod(3F) 

chmod: change mode.chmod(l) 

umask: set file-creation mode mask.umask(l) 

chmod: change mode of file.chmod(2) 

bs: a compiler/interpreter for modest-sized programs.bs(l) 

floating-point/ frexp, ldexp, modf: manipulate parts of.frexp(3C) 

touch: update access and modification times of a file.touch(l) 

utime: set file access and modification times.utime(2) 

profile, monitor: prepare execution.monitor(3C) 

moo: guessing game.moo(6) 

package for formatting/ mosd: the OSDD adapter macro.mosd(5) 

mount: mount a file system.mount(2) 

mount: mount a file system.mount(2) 

mnttab: mounted file system table.mnttab(4) 

cp, In, mv: copy, link or move files.cp(l) 

lseek: move read/write file pointer.lseek(2) 

formatting a permuted index, mptx: the macro package for.mptx(5) 

/erand48, lrand48, nrand48, mrand48, jrand48, srand48,/.drand48(3C) 

operations, msgctl: message control.msgctl(2) 

msgget: get message queue.msgget(2) 

msgop: message operations.msgop(2) 

(shared memory)/ maus: multiple-access-user-space.maus(2) 

typesetting view graphs and/ mv: a troff macro package for .mv(5) 

cp, In, mv: copy, link or move files.cp(l) 

graphs, and slides, mmt, mvt: typeset documents, view .mmt(l) 

log, alog, dlog, clog: Fortran natural logarithm intrinsic/.log(3F) 

/dnint, nint, idnint: Fortran nearest integer functions.round(3F) 

mathematical text for/eqn, neqn, checkeq: format .eqn(l) 

definitions for eqn and neqn. /special character.eqnchar(5) 

PCL network, net: execute a command on the.net(lC) 

execute a command on the PCL network.net:.net(lC) 

operation status of the NSC network, nscstat: query the .nscstat(lC) 

to another UNIX on the NSC network, nusend: send files .nusend(lC) 

re-route jobs from the NSC network to RJE. nsctorje:.nsctorje(lC) 

commands, stat: statistical network useful with graphical .stat(lG) 

a text file, newform: change the format of.newform(l) 

newgrp: log in to a new group.newgrp(l) 

news: print news items.news(l) 

news: print news items.news(l) 

process, nice: change priority of a .nice(2) 

priority, nice: run a command at low .nice(l) 

integer/ anint, dnint, nint, idnint: Fortran nearest .round(3F) 

nl: line numbering filter.nl(l) 

list, nlist: get entries from name .nlist(3C) 

nm: print name list.nm.pdp(l) 

object file, nm: print name list of common.nm(l) 

hangups and quits, nohup: run a command immune to.nohup(l) 

setjmp, longjmp: non-local goto.setjmp(3C) 

bitwise boolean/ and, or, xor, not, lshift, rshift: Fortran .bool(3F) 

drand48, erand48, lrand48, nrand48, mrand48, jrand48,/.drand48(3C) 

nroff: format text.nroff( 1) 

format mathematical text for nroff or troff./checkeq:.eqn(l) 

tbl: format tables for nroff or troff.tbl(l) 

constructs, deroff: remove nroff/troff, tbl, and eqn .deroff(l) 

the operation status of the NSC network, nscstat: query.nscstat(lC) 

files to another UNIX on the NSC network, nusend: send.nusend(lC) 

re-route jobs from the NSC network to RJE. nsctorje:.nsctorje(lC) 

status of the NSC network, nscstat: query the operation .nscstat(lC) 

the NSC network to RJE. nsctorje: re-route jobs from .nsctorje(lC) 

nl: line numbering filter.nl( 1) 

sputl, sgetl: access long numeric data in a machine/.sputl(3X) 

graphics: access graphical and numerical commands.graphics(lG) 

UNIX on the NSC network, nusend: send files to another.nusend(lC) 

common/convert: convert object and archive files to.convert(l) 
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Permuted Index 


ldfcn: common object file access routines.ldfcn(4) 

cprs: compress an IS25 object file.cprs(l) 

dump selected parts of an object file, dump: .dump(l) 

ldopen, ldaopen: open a common object file for reading.ldopen(3X) 

number entries of a common object file function, /line .ldlread(3X) 

ldaclose: close a common object file, ldclose,.ldclose(3X) 

the file header of a common object file, ldfhread: read .ldfhread(3X) 

of a section of a common object file, /number entries.ldlseek(3X) 

file header of a common object file, /to the optional.ldohseek(3X) 

of a section of a common object file, /entries.ldrseek(3X) 

section header of a common object file, /indexed/named .ldshread(3X) 

section of a common object file, /indexed/named .ldsseek(3X) 

symbol table entry of a common object file, /the index of a.ldtbindex(3X) 

symbol table entry of a common object file, /read an indexed .ldtbread(3X) 

the symbol table of a common object file, /seek to.ldtbseek(3X) 

number entries in a common object file, linenum: line .linenum(4) 

C source listing from 3B20S object file, list: produce.list(l) 

nm: print name list of common object file.nm(l) 

information for a common object file, /relocation .reloc(4) 

section header for a common object file, scnhdr:.scnhdr(4) 

information from a common object file, /and line number.strip(l) 

format, syms: common object file symbol table.syms(4) 

file header for common object files, filehdr: .filehdr(4) 

Id: link editor for common object files.ld(l) 

print section sizes of common object files, size:.size(l) 

size: print sizes of object files.size.pdp(l) 

find ordering relation for an object library, lorder:.lorder(l) 

sky: obtain ephemerides.sky(6) 

od: octal dump.od(l) 

od: octal dump.od(l) 

dpr: off-line print.dpr(lC) 

reading, ldopen, ldaopen: open a common object file for .ldopen(3X) 

fopen, freopen, fdopen: open a stream.fopen(3S) 

dup: duplicate an open file descriptor.dup(2) 

open: open for reading or writing.open(2) 

writing, open: open for reading or .open(2) 

network, nscstat: query the operation status of the NSC .nscstat(lC) 

/(shared memory) operations.maus(2) 

memcmp, memcpy, memset: memory operations, memccpy, memchr,.memory(3C) 

msgctl: message control operations.msgctl(2) 

msgop: message operations.msgop(2) 

semctl: semaphore control operations.semctl(2) 

semop: semaphore operations.semop(2) 

shmctl: shared memory control operations.shmctl(2) 

shmop: shared memory operations.shmop(2) 

strcspn, strtok: string operations, /strpbrk, strspn, .string(3C) 

join: relational database operator.join(l) 

vector, getopt: get option letter from argument .getopt(3C) 

common/ ldohseek: seek to the optional file header of a.ldohseek(3X) 

fcntl: file control options.fcntl(5) 

stty:setthe options for a terminal.stty(1) 

getopt: parse command options.getopt(l) 

Fortran bitwise boolean/ and, or, xor, not, lshift, rshift:.bool(3F) 

object library, lorder: find ordering relation for an.lorder(l) 

a directory, or a special or ordinary file, mknod: make .mknod(2) 

formatting/ mosd: the OSDD adapter macro package for.mosd(5) 

documents formatted with/mm, osdd, checkmm: print/check.mm(l) 

dial: establish an out-going terminal line/.dial(3C) 

assembler and link editor output, a.out: common.a.out(4) 

assembler and link editor output, a.out: PDP-11 .a.out.pdp(4) 

sprintf: print formatted output, printf, fprintf,.printf(3S) 

gcat: send phototypesetter output to the HONEYWELL 6000.gcat(lC) 

chown: change owner and group of a file.chown(2) 

chown, chgrp: change owner or group.chown(l) 

and expand files, pack, peat, unpack: compress.pack(l) 

permuted/ mptx: the macro package for formatting a.mptx(5) 

documents, mm: the MM macro package for formatting .mm(5) 

mosd: the OSDD adapter macro package for formatting/.mosd(5) 

graphs and/ mv: a troff macro package for typesetting view.mv(5) 

standard buffered input/output package, stdio: .stdio(3S) 

interprocess communication package, stdipc: standard .stdipc(3C) 

4014 terminal. 4014: paginator for the Tektronix.4014(1) 
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Permuted Index 


process, process group, and parent process IDs. /get.getpid(2) 

getopt: parse command options.getopt(l) 

passwd: change login password.passwd(l) 

passwd: password file.passwd(4) 

/setpwent, endpwent: get password file entry.getpwent(3C) 

putpwent: write password file entry.putpwent(3C) 

passwd: password file.passwd(4) 

getpass: read a password.getpass(3C) 

passwd: change login password.passwd(l) 

several files or subsequent/ paste: merge same lines of.paste(l) 

dimame: deliver portions of path names, basename,.basename(l) 

directory, getcwd: get path-name of current working .getcwd(3C) 

fgrep: search a file for a pattern, grep, egrep, .grep(l) 

processing language, awk: pattern scanning and.awk(l) 

signal, pause: suspend process until.pause(2) 

expand files, pack, peat, unpack: compress and .pack(l) 

cc, pcc: C compiler.cc(l) 

net: execute a command on the PCL network.net(lC) 

a process, popen, pclose: initiate pipe to/from .popen(3S) 

as: assembler for PDP-11.as.pdp( 1) 

editor output, a.out: PDP-11 assembler and link .a.out.pdp(4) 

/convert archive files from PDP-11 to common archive/.arcv(l) 

truth value about your/ pdpl 1, u3b, u3b5, vax: provide.machid(l) 

mesg: permit or deny messages.mesg(l) 

macro package for formatting a permuted index, mptx: the.mptx(5) 

ptx: permuted index.ptx(l) 

format, acct: per-process accounting file.acct(4) 

sys_nerr: system error/ perror, ermo, sys_errlist,.perror(3C) 

HONEYWELL 6000. gcat: send phototypesetter output to the.gcat(lC) 

tc: phototypesetter simulator.tc(l) 

split: split a file into pieces.split(l) 

channel, pipe: create an interprocess.pipe(2) 

tee: pipe fitting.tee( 1) 

popen, pclose: initiate pipe to/from a process.popen(3S) 

data in memory, plock: lock process, text, or .plock(2) 

plot: graphics interface.plot(4) 

subroutines, plot: graphics interface .plot(3X) 

images, pnch: file format for card .pnch(4) 

ftell: reposition a file pointer in a stream, /rewind,.fseek(3S) 

lseek: move read/write file pointer.lseek(2) 

to/from a process, popen, pclose: initiate pipe.popen(3S) 

and library maintainer for portable archives./archive.ar(l) 

basename, dirname: deliver portions of path names.basename(l) 

banner: make posters.banner(l) 

logarithm,/ exp, log, log 10, pow, sqrt: exponential, .exp(3M) 

/sqrt: exponential, logarithm, power, square root functions.exp(3M) 

pr: print files.pr(l) 

for troff. cw, checkcw: prepare constant-width text .cw(l) 

monitor: prepare execution profile.monitor(3C) 

epp: the C language preprocessor.cpp(l) 

unget: undo a previous get of an SCCS file.unget(l) 

graphical/ gps: graphical primitive string, format of.gps(4) 

types: primitive system data types.types(5) 

prs: print an SCCS file.prs(l) 

date: print and set the date.date(l) 

cal: print calendar.cal(l) 

of a file, sum: print checksum and block count.sum(l) 

editing activity, sact: print current SCCS file .sact(l) 

dpr: off-line print.dpr(lC) 

man, manprog: print entries in this manual.man(l) 

cat: concatenate and print files.cat(l) 

scat: concatenate and print files on synchronous/.scat(l) 

pr: print files.pr(l) 

printf, fprintf, sprintf: print formatted output.printf(3S) 

lpstat: print LP status information.lpstat(l) 

nm: print name list.nm.pdp(l) 

object file, nm: print name list of common.nm(l) 

system, uname: print name of current UNIX .uname(l) 

news: print news items.news(l) 

file(s). acctcom: search and print process accounting.acctcom(l) 

object files, size: print section sizes of common .size(l) 

size: print sizes of object files.size.pdp(l) 
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Permuted Index 


names, id: print user and group IDs and.id(l) 

formatted/mm, osdd, checkmm: print/check documents .mm(l) 

HONEYWELL sending daemon, line printer daemon, dpd, lpd: .dpd(lC) 

requests to an LP line printer./cancel: send/cancel.lp( 1) 

and print files on synchronous printer, scat: concatenate .scat(l) 

lpr: line printer spooler.lpr( 1) 

vpr: Versatec printer spooler.vpr(l) 

disable: enable/disable LP printers, enable,.enable(l) 

print formatted output, printf, fprintf, sprintf:.printf(3S) 

nice: run a command at low priority.nice(l) 

nice: change priority of a process.nice(2) 

acct: enable or disable process accounting.acct(2) 

acctcom: search and print process accounting file(s).acctcom(l) 

times, times: get process and child process .times(2) 

timex: time a command; report process data and system/ .timex(l) 

exit, _exit: terminate process.exit(2) 

fork: create a new process.fork(2) 

/getpgrp, getppid: get process, process group, and parent/.getpid(2) 

setpgrp: set process group ID.setpgrp(2) 

process group, and parent process IDs. /get process,.getpid(2) 

inittab: script for the init process.inittab(4) 

kill: terminate a process.kill(l) 

nice: change priority of a process.nice(2) 

kill: send a signal to a process or a group of/.kill(2) 

initiate pipe to/from a process, popen, pclose:.popen(3S) 

getpid, getpgrp, getppid: get process, process group, and/.getpid(2) 

ps: report process status.ps(l) 

memory, plock: lock process, text, or data in.plock(2) 

times: get process and child process times.times(2) 

wait: wait for child process to stop or terminate.wait(2) 

ptrace: process trace.ptrace(2) 

pause: suspend process until signal.pause(2) 

wait: await completion of process.wait(l) 

list of file systems processed by fsck. checklist:.checklist(4) 

to a process or a group of processes, /send a signal .kill(2) 

awk: pattern scanning and processing language.awk(l) 

m4: macro processor.m4(l) 

provide truth value about your processor type. /u3b5, vax: .machid(l) 

alarm: set a process’s alarm clock.alarm(2) 

3B20S object file, list: produce C source listing from .list(l) 

prof: display profile data.prof(l) 

profile, profil: execution time.profil(2) 

prof: display profile data.prof(l) 

monitor: prepare execution profile.monitor(3C) 

profil: execution time profile.profil(2) 

environment at login time, profile: setting up an.profile(4) 

sadp: disk access profiler.sadp(l) 

standard/restricted command programming language./the.sh(l) 

arithmetic: provide drill in number facts.arithmetic(6) 

pdpl 1, u3b, u3b5, vax: provide truth value about your/.machid(l) 

true, false: provide truth values.true(l) 

prs: print an SCCS file.prs(l) 

ps: report process status.ps(l) 

/generate uniformly distributed pseudo-random numbers.drand48(3C) 

ptrace: process trace.ptrace(2) 

ptx: permuted index.ptx(l) 

stream, ungetc: push character back into input .ungetc(3S) 

put character or word on a/ putc, putchar, fputc, putw:.putc(3S) 

character or word on a/ putc, putchar, fputc, putw: put.putc(3S) 

entry, putpwent: write password file.putpwent(3C) 

stream, puts, fputs: put a string on a .puts(3S) 

getutent, getutid, getutline, pututline, setutent, endutent,/.getut(3C) 

a/ putc, putchar, fputc, putw: put character or word on.putc(3S) 

x25rpvc: install or remove a PVC on a link. x25ipvc,.x25ipvc(3C) 

pwd: working directory name.pwd(l) 

qsort: quicker sort.qsort(3C) 

the NSC network, nscstat: query the operation status of.nscstat(lC) 

msgget: get message queue.msgget(2) 

ipcrm: remove a message queue, semaphore set or shared/.ipcrm(l) 

qsort: quicker sort.qsort(3C) 

command immune to hangups and quits, nohup: run a.nohup(l) 

quiz: test your knowledge.quiz(6) 
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Permuted Index 


random-number/ srand, rand: Fortran uniform.rand(3F) 

random-number generator, rand, srand: simple.rand(3C) 

rand, srand: simple random-number generator.rand(3C) 

srand, rand: Fortran uniform random-number generator.rand(3F) 

fsplit: split f77, ratfor, or efl files.fsplit(l) 

dialect, ratfor: rational Fortran .ratfor(l) 

ratfor: rational Fortran dialect.ratfor(l) 

getpass: read a password.getpass(3C) 

entry of a common/ ldtbread: read an indexed symbol table.ldtbread(3X) 

header/ ldshread, ldnshread: read an indexed/named section.ldshread(3X) 

read: read from file.read(2) 

rmail: send mail to users or read mail, mail,.mail(l) 

line: read one line.line(l) 

read: read from file.read(2) 

member of an/ ldahread: read the archive header of a .ldahread(3X) 

common object file, ldfhread: read the file header of a.ldfhread(3X) 

open a common object file for reading, ldopen, ldaopen:.ldopen(3X) 

open: open for reading or writing.open(2) 

lseek: move read/write file pointer.lseek(2) 

cmplx,/ int, ifix, idint, real, float, sngl, dble,.ftype(3F) 

allocator, malloc, free, realloc, calloc: main memory.malloc(3C) 

specify what to do upon receipt of a signal, signal:.signal(2) 

/specify Fortran action on receipt of a system signal.signal(3F) 

ed, red: text editor.ed(l) 

generate C program cross reference, cxref:.cxref(l) 

execute regular expression, regcmp, regex: compile and .regcmp(3X) 

compile, regcmp: regular expression.regcmp(l) 

make: maintain, update, and regenerate groups of programs.make(l) 

regular expression, regcmp, regex: compile and execute .regcmp(3X) 

compile and match routines, regexp: regular expression.regexp(5) 

match routines, regexp: regular expression compile and.regexp(5) 

regcmp: regular expression compile.regcmp(l) 

regex: compile and execute regular expression, regcmp, .regcmp(3X) 

sorted files, comm: select or reject lines common to two.comm(l) 

lorder: find ordering relation for an object/.lorder(l) 

join: relational database operator.join(l) 

for a common object file, reloc: relocation information.reloc(4) 

strip: remove symbols and relocation bits.strip.pdp(l) 

ldrseek, ldnrseek: seek to relocation entries of a/ .ldrseek(3X) 

common object file, reloc: relocation information for a .reloc(4) 

/fmod, fabs: floor, ceiling, remainder, absolute value/.floor(3M) 

mod, amod, dmod: Fortran remaindering intrinsic/ .mod(3F) 

calendar: reminder service.calendar(l) 

ct: spawn getty to a remote terminal.ct(lC) 

file, rmdel: remove a delta from an SCCS .rmdel(l) 

semaphore set or/ipcrm: remove a message queue, .ipcrm(l) 

x25ipvc, x25rpvc: install or remove a PVC on a link.x25ipvc(3C) 

unlink: remove directory entry.unlink(2) 

rm, rmdir: remove files or directories.rm(l) 

eqn constructs, deroff: remove nroff/troff, tbl, and.deroff(l) 

bits, strip: remove symbols and relocation.strip.pdp(l) 

uniq: report repeated lines in a file.uniq(l) 

console, rjestat: RJE status report and interactive status .rjestat(lC) 

clock: report CPU time used.clock(3C) 

communication/ ipcs: report inter-process.ipcs(l) 

timex: time a command; report process data and system/.timex(l) 

ps: report process status.ps(l) 

file, uniq: report repeated lines in a.uniq(l) 

facilities status, ststat: report synchronous terminal.ststat(l) 

trouble: log a trouble report.trouble(l) 

sar: system activity reporter.sar(l) 

stream, fseek, rewind, ftell: reposition a file pointer in a .fseek(3S) 

lp, cancel: send/cancel requests to an LP line/ .lp( 1) 

network to RJE. nsctorje: re-route jobs from the NSC .nsctorje(lC) 

HONEYWELL/fget, fget.demon: retrieve files from the.fget(lC) 

argument, getarg: return Fortran command-line.getarg(3F) 

variable, getenv: return Fortran environment.getenv(3F) 

accounting, mclock: return Fortran time.mclock(3F) 

abs: return integer absolute value.abs(3C) 

string, len: return length of Fortran.len(3F) 

substring, index: return location of Fortran .index(3F) 

logname: return login name of user.logname(3X) 
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Permuted Index 


name, getenv: return value for environment.getenv(3C) 

stat: data returned by stat system call.stat(5) 

reversi: a game of dramatic reversals.reversi(6) 

col: filter reverse line-feeds.col(l) 

reversals, reversi: a game of dramatic .reversi(6) 

file pointer in a/ fseek, rewind, ftell: reposition a .fseek(3S) 

creat: create a new file or rewrite an existing one.creat(2) 

gather files and/or submit RJE jobs, send, gath:.send(lC) 

jobs from the NSC network to RJE. nsctorje: re-route .nsctorje(lC) 

interactive status/rjestat: RJE status report and.rjestat(lC) 

interactive status console, rjestat: RJE status report and.rjestat(lC) 

directories, rm, rmdir: remove files or.rm(l) 

read mail, mail, rmail: send mail to users or .mail(l) 

SCCS file, rmdel: remove a delta from an .rmdel(l) 

directories, rm, rmdir: remove files or.rm(l) 

chroot: change root directory.chroot(2) 

logarithm, power, square root functions, /exponential,.exp(3M) 

/dsqrt, csqrt: Fortran square root intrinsic function.sqrt(3F) 

/tekset, td: graphical device routines and filters.gdev(lG) 

common object file access routines, ldfcn: .ldfcn(4) 

expression compile and match routines, regexp: regular .regexp(5) 

graphical table of contents routines, toe:.toc(lG) 

standard/restricted/ sh, rsh: shell, the.sh(l) 

and, or, xor, not, lshift, rshift: Fortran bitwise/ .bool(3F) 

nice: run a command at low priority.nice(l) 

hangups and quits, nohup: run a command immune to.nohup(l) 

editing activity, sact: print current SCCS file.sact(l) 

sadp: disk access profiler.sadp(l) 

sag: system activity graph.sag(lG) 

sar: system activity reporter.sar(l) 

space allocation, brk, sbrk: change data segment.brk(2) 

formatted input, scanf, fscanf, sscanf: convert.scanf(3S) 

bfs: big file scanner.bfs(l) 

language, awk: pattern scanning and processing.awk(l) 

files on synchronous printer, scat: concatenate and print.scat(l) 

stand-alone programs, see: C compiler for.scc(l) 

the delta commentary of an SCCS delta, ede: change .cdc(l) 

comb: combine SCCS deltas.comb(l) 

make a delta (change) to an SCCS file, delta: .delta(l) 

sact: print current SCCS file editing activity.sact(l) 

get: get a version of an SCCS file.get(l) 

prs: print an SCCS file.prs(l) 

rmdel: remove a delta from an SCCS file.rmdel(l) 

compare two versions of an SCCS file, sccsdiff: .sccsdiff(l) 

sccsfile: format of SCCS file.sccsfile(4) 

undo a previous get of an SCCS file, unget: .unget(l) 

val: validate SCCS file.val(l) 

admin: create and administer SCCS files.admin(l) 

what: identify SCCS files.what(l) 

of an SCCS file, sccsdiff: compare two versions.sccsdiff(l) 

sccsfile: format of SCCS file.sccsfile(4) 

common object file, scnhdr: section header for a .scnhdr(4) 

terminals.se: screen editor for video .se(l) 

inittab: script for the init process.inittab(4) 

sdb: symbolic debugger.sdb (1) 

program, sdiff: side-by-side difference.sdiff(l) 

terminals, se: screen editor for video.se(l) 

grep, egrep, fgrep: search a file for a pattern.grep(l) 

accounting file(s). acctcom: search and print process.acctcom(l) 

lsearch: linear search and update.lsearch(3C) 

bsearch: binary search.bsearch(3C) 

hcreate, hdestroy: manage hash search tables, hsearch, .hsearch(3C) 

tdelete, twalk: manage binary search trees, tsearch,.tsearch(3C) 

jotto: secret word game.jotto(6) 

object file, scnhdr: section header for a common.scnhdr(4) 

object/ /read an indexed/named section header of a common.ldshread(3X) 

/to line number entries of a section of a common object/.ldlseek(3X) 

/to relocation entries of a section of a common object/.ldrseek(3X) 

/seek to an indexed/named section of a common object/.ldsseek(3X) 

files, size: print section sizes of common object.size(l) 

sed: stream editor.sed(l) 

/mrand48, jrand48, srand48, seed48, lcong48: generate/.drand48(3C) 
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Permuted Index 


section of/ ldsseek, ldnsseek: seek to an indexed/named.ldsseek(3X) 

a section/ ldlseek,ldnlseek: seek to line number entries of.ldlseek(3X) 

a section/ ldrseek, ldnrseek: seek to relocation entries of .ldrseek(3X) 

header of a common/ ldohseek: seek to the optional file.ldohseek(3X) 

common object file, ldtbseek: seek to the symbol table of a.ldtbseek(3X) 

shmget: get shared memory segment.shmget(2) 

brk, sbrk: change data segment space allocation.brk(2) 

to two sorted files, comm: select or reject lines common.comm(l) 

greek: select terminal filter.greek(l) 

of a file, cut: cut out selected fields of each line.cut(l) 

file, dump: dump selected parts of an object.dump(l) 

semctl: semaphore control operations.semctl(2) 

semop: semaphore operations.semop(2) 

ipcrm: remove a message queue, semaphore set or shared memory/.ipcrm(l) 

semget: get set of semaphores.semget(2) 

operations, semctl: semaphore control.semctl(2) 

semget: get set of semaphores.semget(2) 

semop: semaphore operations.semop(2) 

a group of processes, kill: send a signal to a process or .kill(2) 

the NSC network, nusend: send files to another UNIX on .nusend(lC) 

6000. fsend: send files to the HONEYWELL.fsend(lC) 

and/or submit RJE jobs, send, gath: gather files .send(lC) 

gcosmail: send mail to HIS user.gcosmail(lC) 

mail, mail, rmail: send mail to users or read .mail(l) 

the HONEYWELL 6000. gcat: send phototypesetter output to .gcat(lC) 

line printer. Ip, cancel: send/cancel requests to an LP.lp( 1) 

daemon, dpd, lpd: HONEYWELL sending daemon, line printer.dpd(lC) 

stream, setbuf: assign buffering to a .setbuf(3S) 

IDs. setuid, setgid: set user and group .setuid(2) 

getgrent, getgrgid, getgrnam, setgrent, endgrent: get group/.getgrent(3C) 

goto, setjmp, longjmp: non-local.setjmp(3C) 

encryption, crypt, setkey, encrypt: generate DES .crypt(3C) 

setpgrp: set process group ID.setpgrp(2) 

getpwent, getpwuid, getpwnam, setpwent, endpwent: get/ .getpwent(3C) 

login time, profile: setting up an environment at.profile(4) 

gettydefs: speed and terminal settings used by getty.gettydefs(4) 

group IDs. setuid, setgid: set user and.setuid(2) 

/getutid, getutline, pututline, setutent, endutent, utmpname:/.getut(3C) 

data in a machine/ sputl, sgetl: access long numeric.sputl(3X) 

standard/restricted command/ sh, rsh: shell, the.sh(l) 

operations, shmctl: shared memory control.shmctl(2) 

queue, semaphore set or shared memory id. /a message .ipcrm(l) 

/multiple-access-user-space (shared memory) operations.maus(2) 

shmop: shared memory operations.shmop(2) 

shmget: get shared memory segment.shmget(2) 

system: issue a shell command from Fortran.system(3F) 

system: issue a shell command.system(3S) 

command programming/sh, rsh: shell, the standard/restricted .sh(l) 

operations, shmctl: shared memory control.shmctl(2) 

segment, shmget: get shared memory .shmget(2) 

operations, shmop: shared memory.shmop(2) 

program, sdiff: side-by-side difference .sdiff(l) 

transfer-of-sign intrinsic/ sign, isign, dsign: Fortran.sign(3F) 

login: sign on.login(l) 

terminal, stlogin: sign on to synchronous.stlogin(l) 

pause: suspend process until signal.pause(2) 

what to do upon receipt of a signal, signal: specify.signal(2) 

action on receipt of a system signal, /specify Fortran.signal(3F) 

on receipt of a system/ signal: specify Fortran action.signal(3F) 

upon receipt of a signal, signal: specify what to do.signal(2) 

of processes, kill: send a signal to a process or a group.kill(2) 

ssignal, gsignal: software signals.ssignal(3C) 

lex: generate programs for simple lexical tasks.lex(l) 

generator, rand, srand: simple random-number.rand(3C) 

tc: phototypesetter simulator.tc(l) 

atan, atan2: trigonometric/ sin, cos, tan, asin, acos,.trig(3M) 

intrinsic function, sin, dsin, csin: Fortran sine.sin(3F) 

sin, dsin, csin: Fortran sine intrinsic function.sin(3F) 

/dsinh: Fortran hyperbolic sine intrinsic function.sinh(3F) 

functions, sinh, cosh, tanh: hyperbolic .sinh(3M) 

hyperbolic sine intrinsic/ sinh, dsinh: Fortran.sinh(3F) 

common object files, size: print section sizes of.size(l) 
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Permuted Index 


files, size: print sizes of object .size.pdp(l) 

size: print section sizes of common object files.size(l) 

size: print sizes of object files.size.pdp(l) 

sky: obtain ephemerides.sky(6) 

an interval, sleep: suspend execution for.sleep(l) 

interval, sleep: suspend execution for.sleep(3C) 

documents, view graphs, and slides, mmt, mvt: typeset .mmt(l) 

typesetting view graphs and slides, /macro package for.mv(5) 

current/ ttyslot: find the slot in the utmp file of the.ttyslot(3C) 

spline: interpolate smooth curve.spline(lG) 

int, ifix, idint, real, float, sngl, dble, cmplx, dcmplx,/ .ftype(3F) 

sno: SNOBOL interpreter.sno(l) 

sno: SNOB OL interpreter.sno(l) 

ssignal, gsignal: software signals.ssignal(3C) 

sort: sort and/or merge files.sort(l) 

qsort: quicker sort.qsort(3C) 

sort: sort and/or merge files.sort(l) 

tsort: topological sort.tsort(l) 

or reject lines common to two sorted files, comm: select.comm(l) 

object file, list: produce C source listing from 3B20S.list(l) 

brk, sbrk: change data segment space allocation.brk(2) 

terminal, ct: spawn getty to a remote.ct(lC) 

sys3b: 3B20S specific system calls.sys3b(2) 

fspec: format specification in text files.fspec(4) 

receipt of a system/ signal: specify Fortran action on .signal(3F) 

receipt of a signal, signal: specify what to do upon.signal(2) 

used by getty. gettydefs: speed and terminal settings.gettydefs(4) 

hashcheck: find spelling/ spell, hashmake, spellin,.spell(l) 

spelling/spell, hashmake, spellin, hashcheck: find.spell(l) 

spellin, hashcheck: find spelling errors./hashmake, .spell(l) 

curve, spline: interpolate smooth.spline(lG) 

split: split a file into pieces.split(l) 

csplit: context split.csplit(l) 

files, fsplit: split f77, ratfor, or efl.fsplit(l) 

pieces, split: split a file into .split(l) 

lpr: line printer spooler.lpr(l) 

vpr: Versatec printer spooler.vpr(l) 

output, printf, fprintf, sprintf: print formatted .printf(3S) 

numeric data in a machine/ sputl, sgetl: access long.sputl(3X) 

square root intrinsic/ sqrt, dsqrt, csqrt: Fortran .sqrt(3F) 

power,/ exp, log, log 10, pow, sqrt: exponential, logarithm,.exp(3M) 

exponential, logarithm, power, square root functions, /sqrt: .exp(3M) 

sqrt, dsqrt, csqrt: Fortran square root intrinsic/.sqrt(3F) 

random-number generator, srand, rand: Fortran uniform.rand(3F) 

generator, rand, srand: simple random-number .rand(3C) 

/nrand48, mrand48, jrand48, srand48, seed48, lcong48:/.drand48(3C) 

input, scanf, fscanf, sscanf: convert formatted .scanf(3S) 

signals, ssignal, gsignal: software .ssignal(3C) 

see: C compiler for stand-alone programs.scc(l) 

package, stdio: standard buffered input/output .stdio(3S) 

communication/ stdipc: standard interprocess.stdipc(3C) 

sh, rsh: shell, the standard/restricted command/.sh(l) 

system call, stat: data returned by stat .stat(5) 

stat, fstat: get file status.stat(2) 

useful with graphical/ stat: statistical network .stat(lG) 

stat: data returned by stat system call.stat(5) 

with graphical/stat: statistical network useful .stat(lG) 

ustat: get file system statistics.ustat(2) 

status report and interactive status console, rjestat: RJE.rjestat(lC) 

lpstat: print LP status information.lpstat(l) 

feof, clearerr, fileno: stream status inquiries, ferror, .ferror(3S) 

control, uustat: uucp status inquiry and job.uustat(lC) 

communication facilities status, /report inter-process .ipcs(l) 

nscstat: query the operation status of the NSC network.nscstat(lC) 

ps: report process status.ps(l) 

status console, rjestat: RJE status report and interactive .rjestat(lC) 

stat, fstat: get file status.stat(2) 

terminal facilities status./report synchronous .ststat(l) 

input/output package, stdio: standard buffered.stdio(3S) 

communication package, stdipc: standard interprocess.stdipc(3C) 

stime: set time.stime(2) 

synchronous terminal, stlogin: sign on to.stlogin(l) 
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Permuted Index 


wait for child process to stop or terminate, wait:.wait(2) 

stmcmp, strcpy, stmcpy,/ strcat, stmcat, strcmp,.string(3C) 

/strcpy, stmcpy, strlen, strchr, strrchr, strpbrk,/.string(3C) 

stmcpy,/ strcat, stmcat, strcmp, strncmp, strcpy,.string(3C) 

/stmcat, strcmp, stmcmp, strcpy, stmcpy, strlen,/ .string(3C) 

/strrchr, strpbrk, strspn, strcspn, strtok: string/.string(3C) 

sed: stream editor.sed(l) 

fflush: close or flush a stream, fclose, .fclose(3S) 

fopen, freopen, fdopen: open a stream.fopen(3S) 

reposition a file pointer in a stream, fseek, rewind, ftell: .fseek(3S) 

get character or word from stream, /getchar, fgetc, getw:.getc(3S) 

fgets: get a string from a stream, gets, .gets(3S) 

put character or word on a stream, /putchar, fputc, putw: .putc(3S) 

puts, fputs: put a string on a stream.puts(3S) 

setbuf: assign buffering to a stream.setbuf(3S) 

/feof, clearerr, fileno: stream status inquiries.ferror(3S) 

push character back into input stream, ungetc: .ungetc(3S) 

long integer and base-64 ASCII string. /164a: convert between .a641(3C) 

convert date and time to string, /asctime, tzset:.ctime(3C) 

floating-point number to string, /fcvt, gcvt: convert.ecvt(3C) 

gps: graphical primitive string, format of graphical/.gps(4) 

gets, fgets: get a string from a stream.gets(3S) 

len: return length of Fortran string.len(3F) 

puts, fputs: put a string on a stream.puts(3S) 

strspn, strcspn, strtok: string operations, /strpbrk,.string(3C) 

number, atof: convert ASCII string to floating-point .atof(3C) 

strtol, atol, atoi: convert string to integer.strtol(3C) 

relocation bits, strip: remove symbols and.strip.pdp(l) 

number information from a/ strip: strip symbol and line.strip(l) 

information from a/strip: strip symbol and line number.strip(l) 

/strncmp, strcpy, strncpy, strlen, strchr, strrchr,/.string(3C) 

strcpy, strncpy,/ strcat, stmcat, strcmp, strncmp,.string(3C) 

strcat, strncat, strcmp, stmcmp, strcpy, stmcpy,/ .string(3C) 

/strcmp, stmcmp, strcpy, stmcpy, strlen, strchr,/ .string(3C) 

/strlen, strchr, strrchr, strpbrk, strspn, strcspn,/.string(3C) 

/strncpy, strlen, strchr, strrchr, strpbrk, strspn,/.string(3C) 

/strchr, strrchr, strpbrk, strspn, strcspn, strtok:/ .string(3C) 

/strpbrk, strspn, strcspn, strtok: string operations.string(3C) 

string to integer, strtol, atol, atoi: convert.strtol(3C) 

terminal facilities status, ststat: report synchronous.ststat(l) 

terminal, stty: set the options for a.stty(1) 

another user, su: become super-user or .su(l) 

gath: gather files and/or submit RJE jobs, send,.send(lC) 

intro: introduction to subroutines and libraries.intro(3) 

plot: graphics interface subroutines.plot(3X) 

/same lines of several files or subsequent lines of one file.paste(l) 

return location of Fortran substring, index:.index(3F) 

count of a file, sum: print checksum and block.sum(l) 

du: summarize disk usage.du(l) 

sync: update the super block.sync(l) 

sync: update super-block.sync(2) 

su: become super-user or another user.su(l) 

interval, sleep: suspend execution for an .sleep(l) 

interval, sleep: suspend execution for.sleep(3C) 

pause: suspend process until signal.pause(2) 

swab: swap bytes.swab(3C) 

swab: swap bytes.swab(3C) 

information from/ strip: strip symbol and line number.strip(l) 

object/ /compute the index of a symbol table entry of a common .ldtbindex(3X) 

ldtbread: read an indexed symbol table entry of a common/.ldtbread(3X) 

syms: common object file symbol table format.syms(4) 

object/ ldtbseek: seek to the symbol table of a common.ldtbseek(3X) 

sdb: symbolic debugger.sdb(l) 

strip: remove symbols and relocation bits.strip.pdp(l) 

symbol table format, syms: common object file.syms(4) 

sync: update super-block.sync(2) 

sync: update the super block.sync(l) 

concatenate and print files on synchronous printer, scat:.scat(l) 

facilities/ststat: report synchronous terminal.ststat(l) 

stlogin: sign on to synchronous terminal.stlogin(l) 

calls. sys3b: 3B20S specific system .sys3b(2) 

error/ perror, errno, sys_errlist, sys_nerr: system.perror(3C) 


- 29 - 











































































Permuted Index 


perror, ermo, sys_errlist, sys_nerr: system error/ .perror(3C) 

/compute the index of a symbol table entry of a common object/.ldtbindex(3X) 

file, /read an indexed symbol table entry of a common object.ldtbread(3X) 

common object file symbol table format, syms:.syms(4) 

master device information table, master:.master.dec(4) 

master device information table, master:.master.u3b(4) 

mnttab: mounted file system table.mnttab(4) 

ldtbseek: seek to the symbol table of a common object file.ldtbseek(3X) 

toe: graphical table of contents routines.toc(lG) 

tbl: format tables for nroff or troff.tbl(l) 

hdestroy: manage hash search tables, hsearch, hcreate,.hsearch(3C) 

tabs: set tabs on a terminal.tabs(l) 

tabs: set tabs on a terminal.tabs(l) 

a file, tail: deliver the last part of.tail(l) 

trigonometric/ sin, cos, tan, asin, acos, atan, atan2:.trig(3M) 

intrinsic function, tan, dtan: Fortran tangent .tan(3F) 

tan, dtan: Fortran tangent intrinsic function.tan(3F) 

/dtanh: Fortran hyperbolic tangent intrinsic function.tanh(3F) 

hyperbolic tangent intrinsic/ tanh, dtanh: Fortran .tanh(3F) 

sinh, cosh, tanh: hyperbolic functions.sinh(3M) 

hpio: HP 2645A terminal tape file archiver.hpio(l) 

tar: tape file archiver.tar(l) 

tar: tape file archiver.tar(l) 

programs for simple lexical tasks, lex: generate.lex(l) 

deroff: remove nroff/troff, tbl, and eqn constructs.deroff(l) 

or troff. tbl: format tables for nroff.tbl(l) 

tc: phototypesetter simulator.tc(l) 

hpd, erase, hardcopy, tekset, td: graphical device routines/.gdev(lG) 

search trees, tsearch, tdelete, twalk: manage binary.tsearch(3C) 

tee: pipe fitting.tee(l) 

hpd, erase, hardcopy, tekset, td: graphical device/ .gdev(lG) 

4014: paginator for the Tektronix 4014 terminal.4014(1) 

temporary file, tmpnam, tempnam: create a name for a.tmpnam(3S) 

tmpfile: create a temporary file.tmpfile(3S) 

tempnam: create a name for a temporary file, tmpnam,.tmpnam(3S) 

terminals, term: conventional names for.term(5) 

for the Tektronix 4014 terminal. 4014: paginator.4014(1) 

functions of the DASI450 terminal. 450: handle special. 450(1) 

ct: spawn getty to a remote terminal.ct(lC) 

generate file name for terminal, ctermid:.ctermid(3S) 

ststat: report synchronous terminal facilities status.ststat(l) 

greek: select terminal filter.greek(l) 

dial: establish an out-going terminal line connection.dial(3C) 

getty. gettydefs: speed and terminal settings used by .gettydefs(4) 

sign on to synchronous terminal, stlogin: .stlogin(l) 

stty: set the options for a terminal.stty(1) 

tabs: set tabs on a terminal.tabs(l) 

hpio: HP 2645A terminal tape file archiver.hpio(l) 

isatty: find name of a terminal, ttyname,.ttyname(3C) 

functions of DASI 300 and 300s terminals, /handle special. 300(1) 

of HP 2640 and 2621-series terminals./special functions.hp(l) 

tty: get the terminal ’ s name.tty(1) 

se: screen editor for video terminals.se(l) 

term: conventional names for terminals.term(5) 

kill: terminate a process.kill(l) 

abort: terminate Fortran program.abort(3F) 

exit, _exit: terminate process.exit(2) 

for child process to stop or terminate, wait: wait.wait(2) 

command, test: condition evaluation .test(l) 

quiz: test your knowledge.quiz(6) 

ed, red: text editor.ed(l) 

change the format of a text file, newform:.newform(l) 

fspec: format specification in text files.fspec(4) 

/checkeq: format mathematical text for nroff or troff.eqn( 1) 

prepare constant-width text for troff. cw, checkcw: .cw(l) 

nroff: format text.nroff(l) 

plock: lock process, text, or data in memory.plock(2) 

troff: typeset text.troff(l) 

ttt, cubic: tic-tac-toe.ttt(6) 

data and system/timex: time a command; report process.timex(l) 

time: time a command.time(l) 

mclock: return Fortran time accounting.mclock(3F) 
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Permuted Index 


time: get time.time(2) 

profil: execution time profile.profil(2) 

up an environment at login time, profile: setting.profile(4) 

stime: set time.stime(2) 

time: time a command.time(l) 

time: get time.time(2) 

tzset: convert date and time to string, /asctime,.ctime(3C) 

clock: report CPU time used.clock(3C) 

process times, times: get process and child .times(2) 

update access and modification times of a file, touch:.touch(l) 

get process and child process times, times: .times(2) 

file access and modification times, utime: set.utime(2) 

process data and system/ timex: time a command; report.timex(l) 

file, tmpfile: create a temporary.tmpfile(3S) 

for a temporary file, tmpnam, tempnam: create a name.tmpnam(3S) 

/tolower, _toupper, _tolower, toascii: translate characters.conv(3C) 

contents routines, toe: graphical table of.toc(lG) 

popen, pclose: initiate pipe to/from a process.popen(3S) 

toupper, tolower, toupper, _tolower, toascii: translate/.conv(3C) 

toascii: translate/ toupper, tolower, toupper, tolower,.conv(3C) 

tsort: topological sort.tsort(l) 

modification times of a file, touch: update access and .touch(l) 

translate/ toupper, tolower, _toupper, _tolower, toascii: .conv(3C) 

_tolower, toascii: translate/ toupper, tolower, toupper, .conv(3C) 

tplot: graphics filters.tplot(lG) 

tr: translate characters.tr(l) 

ptrace: process trace.ptrace(2) 

sign, isign, dsign: Fortran transfer-of-sign intrinsic/ .sign(3F) 

/_toupper, _tolower, toascii: translate characters.conv(3C) 

tr: translate characters.tr(l) 

ftw: walk a file tree.ftw(3C) 

twalk: manage binary search trees, tsearch, tdelete,.tsearch(3C) 

tan, asin, acos, atan, atan2: trigonometric functions, /cos, .trig(3M) 

constant-width text for troff. cw, checkcw: prepare .cw(l) 

mathematical text for nroff or troff./neqn, checkeq: format.eqn(l) 

typesetting view graphs/ mv: a troff macro package for.mv(5) 

format tables for nroff or troff. tbl:.tbl(l) 

troff: typeset text.troff(l) 

trouble: log a trouble report.trouble(l) 

trouble: log a trouble report.trouble(l) 

values, true, false: provide truth.true(l) 

pdpl 1, u3b, u3b5, vax: provide truth value about your/ .machid(l) 

true, false: provide truth values.true(l) 

manage binary search trees, tsearch, tdelete, twalk: .tsearch(3C) 

tsort: topological sort.tsort(l) 

ttt, cubic: tic-tac-toe.ttt(6) 

tty: get the terminal ’ s name.tty(1) 

graphics for the extended TTY-37 type-box. greek: .greek(5) 

a terminal, ttyname, isatty: find name of.ttyname(3C) 

utmp file of the current/ ttyslot: find the slot in the.ttyslot(3C) 

trees, tsearch, tdelete, twalk: manage binary search.tsearch(3C) 

ichar, char: explicit Fortran type conversion, /dcmplx,.ftype(3F) 

file: determine file type.file(l) 

value about your processor type./vax: provide truth.machid(l) 

for the extended TTY-37 type-box. greek: graphics.greek(5) 

types, types: primitive system data.types(5) 

types: primitive system data types.types(5) 

graphs, and slides, mmt, mvt: typeset documents, view.mmt(l) 

troff: typeset text.troff(l) 

mv: a troff macro package for typesetting view graphs and/.mv(5) 

/localtime, gmtime, asctime, tzset: convert date and time/.ctime(3C) 

value about your/ pdpl 1, u3b, u3b5, vax: provide truth.machid(l) 

about your/pdpl 1, u3b, u3b5, vax: provide truth value .machid(l) 

getpw: get name from UID.getpw(3C) 

limits, ulimit: get and set user .ulimit(2) 

creation mask, umask: set and get file .umask(2) 

mask, umask: set file-creation mode.umask(l) 

umount: unmount a file system.umount(2) 

UNIX system, uname: get name of current .uname(2) 

UNIX system, uname: print name of current.uname(l) 

file, unget: undo a previous get of an SCCS.unget(l) 

an SCCS file, unget: undo a previous get of.unget(l) 
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Permuted Index 


into input stream, ungetc: push character back .ungetc(3S) 

srand, rand: Fortran uniform random-number/ .rand(3F) 

/seed48, lcong48: generate uniformly distributed/.drand48(3C) 

a file, uniq: report repeated lines in.uniq(l) 

mktemp: make a unique file name.mktemp(3C) 

units: conversion program.units(l) 

uuto, uupick: public UNIX-to-UNIX file copy.uuto(lC) 

entry, unlink: remove directory .unlink(2) 

umount: unmount a file system.umount(2) 

files, pack, peat, unpack: compress and expand .pack(l) 

times of a file, touch: update access and modification.touch(l) 

of programs, make: maintain, update, and regenerate groups .make(l) 

lsearch: linear search and update.lsearch(3C) 

sync: update super-block.sync(2) 

sync: update the super block.sync(l) 

du: summarize disk usage.du(l) 

stat: statistical network useful with graphical/.stat(lG) 

id: print user and group IDs and names.id( 1) 

setuid, setgid: set user and group IDs.setuid(2) 

character login name of the user, cuserid: get .cuserid(3S) 

/getgid, getegid: get real user, effective user, real/.getuid(2) 

environ: user environment.environ(5) 

gcosmail: send mail to HIS user.gcosmail(lC) 

ulimit: get and set user limits.ulimit(2) 

logname: return login name of user.logname(3X) 

/get real user, effective user, real group, and/.getuid(2) 

become super-user or another user, su:.su(l) 

the utmp file of the current user, /find the slot in.ttyslot(3C) 

write: write to another user.write(l) 

mail, rmail: send mail to users or read mail.mail(l) 

statistics, ustat: get file system .ustat(2) 

gutil: graphical utilities.gutil(lG) 

modification times, utime: set file access and .utime(2) 

utmp, wtmp: utmp and wtmp entry formats.utmp(4) 

endutent, utmpname: access utmp file entry, /setutent, .getut(3C) 

ttyslot: find the slot in the utmp file of the current user.ttyslot(3C) 

entry formats, utmp, wtmp: utmp and wtmp.utmp(4) 

/pututline, setutent, endutent, utmpname: access utmp file/.getut(3C) 

control, uustat: uucp status inquiry and job.uustat(lC) 

unix copy, uucp, uulog, uuname: unix to.uucp(lC) 

copy, uucp, uulog, uuname: unix to unix.uucp(lC) 

uucp, uulog, uuname: unix to unix copy.uucp(lC) 

file copy, uuto, uupick: public UNIX-to-UNIX.uuto(lC) 

and job control, uustat: uucp status inquiry.uustat(lC) 

UNIX-to-UNIX file copy, uuto, uupick: public .uuto(lC) 

execution, uux: unix to unix command .uux(lC) 

val: validate SCCS file.val(l) 

val: validate SCCS file.val(l) 

/u3b, u3b5, vax: provide truth value about your processor/ .machid(l) 

abs: return integer absolute value.abs(3C) 

cabs, zabs: Fortran absolute value, abs, iabs, dabs,.abs(3F) 

getenv: return value for environment name.getenv(3C) 

ceiling, remainder, absolute value functions, /fabs: floor,.floor(3M) 

true, false: provide truth values.true(l) 

return Fortran environment variable, getenv:.getenv(3F) 

your/ pdpll, u3b, u3b5, vax: provide truth value about .machid(l) 

vc: version control.vc(l) 

option letter from argument vector, getopt: get.getopt(3C) 

assert: verify program assertion.assert(3X) 

vpr: Versatec printer spooler.vpr(l) 

vc: version control.vc(l) 

get: get a version of an SCCS file.get(l) 

sccsdiff: compare two versions of an SCCS file.sccsdiff(l) 

se: screen editor for video terminals.se(l) 

mmt, mvt: typeset documents, view graphs, and slides.mmt(l) 

macro package for typesetting view graphs and slides, /troff.mv(5) 

file system: format of system volume.fs(4) 

vpr: Versatec printer spooler.vpr( 1) 

process, wait: await completion of.wait(l) 

or terminate, wait: wait for child process to stop.wait(2) 

to stop or terminate, wait: wait for child process.wait(2) 

ftw: walk a file tree.ftw(3C) 
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Permuted Index 


wc: word count.wc(l) 

what: identify SCCS files.what(l) 

signal, signal: specify what to do upon receipt of a .signal(2) 

who: who is on the system.who(l) 

who: who is on the system.who(l) 

cd: change working directory.cd(l) 

chdir: change working directory.chdir(2) 

get path-name of current working directory, getcwd: .getcwd(3C) 

pwd: working directory name.pwd(l) 

write: write on a file.write(2) 

putpwent: write password file entry.putpwent(3C) 

write: write to another user.write(l) 

write: write on a file.write(2) 

write: write to another user.write(l) 

open: open for reading or writing.open(2) 

utmp, wtmp: utmp and wtmp entry formats.utmp(4) 

formats, utmp, wtmp: utmp and wtmp entry.utmp(4) 

hunt-the-wumpus. wump: the game of.wump(6) 

install a BX.25 link. x25alnk, x25ilnk: attach or.x25alnk(3C) 

link. x25clnk: change over a BX.25 .x25clnk(3C) 

BX.25 link. x25hlnk, x25dlnk: halt or detach a .x25hlnk(3C) 

detach a BX.25 link. x25hlnk, x25dlnk: halt or .x25hlnk(3C) 

BX.25 link. x25alnk, x25ilnk: attach or install a.x25alnk(3C) 

remove a PVC on a link. x25ipvc, x25rpvc: install or .x25ipvc(3C) 

PVC on a link. x25ipvc, x25rpvc: install or remove a.x25ipvc(3C) 

list(s) and execute command, xargs: construct argument.xargs(l) 

Fortran bitwise/ and, or, xor, not, lshift, rshift:.bool(3F) 

jO, j 1, jn, yO, y 1, yn: Bessel functions.bessel(3M) 

jO, j 1, jn, yO, yl, yn: Bessel functions.bessel(3M) 

compiler-compiler, yacc: yet another.yacc(l) 

jO, jl, jn, yO, yl, yn: Bessel functions.bessel(3M) 

abs, iabs, dabs, cabs, zabs: Fortran absolute value.abs(3F) 
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NAME 

intro - introduction to commands and application programs 

DESCRIPTION 

This section describes, in alphabetical order, publicly-accessible commands. Certain distinctions of pur¬ 
pose are made in the headings: 

(1) Commands of general utility. 

(1C) Commands for communication with other systems. 

(1G) Commands used primarily for graphics and computer-aided design. 

COMMAND SYNTAX 

Unless otherwise noted, commands described in this section accept options and other arguments according 
to the following syntax: 

name [option (s )] [cmdarg(s)] 
where: 


name 

option 


noargletter 

argletter 

optarg 

cmdarg 


The name of an executable file. 

- noargletter(s) or, 

- argletterOoptarg 

where <> is optional white space. 

A single letter representing an option without an argument. 

A single letter representing an option requiring an argument. 

Argument (character string) satisfying preceding argletter. 

Path name (or other command argument) not beginning with - or, - by itself indicating the 
standard input. 


SEE ALSO 

getopt(l), getopt(3C). 

Section 6 of this volume for computer games. 
How to Get Started, at the front of this volume. 


DIAGNOSTICS 

Upon termination, each command returns two bytes of status, one supplied by the system and giving the 
cause for termination, and (in the case of “normal” termination) one supplied by the program (see wait(2) 
and exit(2)). The former byte is 0 for normal termination; the latter is customarily 0 for successful execu¬ 
tion and non-zero to indicate troubles such as erroneous parameters, bad or inaccessible data, or other 
inability to cope with the task at hand. It is called variously “exit code”, “exit status”, or “return code”, 
and is described only where special conventions are involved. 

BUGS 

Regretfully, many commands do not adhere to the aforementioned syntax. 
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NAME 

300, 300s - handle special functions of DASI 300 and 300s terminals 
SYNOPSIS 

300 [ +12 ] [ -n ] [ -dt.l.c ] 

300s [ +12 ] [ -n ] [ -dt,l,c ] 

DESCRIPTION 

300 supports special functions and optimizes the use of the DASI 300 (GSI 300 or DTC 300) terminal; 300s 
performs the same functions for the DASI 300s (GSI 300s or DTC 300s) terminal. It converts half-line for¬ 
ward, half-line reverse, and full-line reverse motions to the correct vertical motions. It also attempts to 
draw Greek letters and other special symbols. It permits convenient use of 12-pitch text. It also reduces 
printing time 5 to 70%. 300 can be used to print equations neatly, in the sequence: 

neqn file ... I nroff I 300 

WARNING: if your terminal has a PLOT switch, make sure it is turned on before 300 is used. 

The behavior of 300 can be modified by the optional flag arguments to handle 12-pitch text, fractional line 
spacings, messages, and delays. 

+12 permits use of 12-pitch, 6 lines/inch text. DASI 300 terminals normally allow only two combi¬ 
nations: 10-pitch, 6 lines/inch, or 12-pitch, 8 lines/inch. To obtain the 12-pitch, 6 lines per inch 
combination, the user should turn the PITCH switch to 12, and use the +12 option. 

—n controls the size of half-line spacing. A half-line is, by default, equal to 4 vertical plot incre¬ 

ments. Because each increment equals 1/48 of an inch, a 10-pitch line-feed requires 8 incre¬ 
ments, while a 12-pitch line-feed needs only 6. The first digit of n overrides the default value, 
thus allowing for individual taste in the appearance of subscripts and superscripts. For example, 
nroff half-lines could be made to act as quarter-lines by using -2. The user could also obtain 
appropriate half-lines for 12-pitch, 8 lines/inch mode by using the option -3 alone, having set 
the PITCH switch to 12-pitch. 

-d t,l,c controls delay factors. The default setting is -d3,90,30. DASI 300 terminals sometimes produce 

peculiar output when faced with very long lines, too many tab characters, or long strings of 
blankless, non-identical characters. One null (delay) character is inserted in a line for every set 
of 1 tabs, and for every contiguous string of c non-blank, non-tab characters. If a line is longer 
than / bytes, l+(total length)/20 nulls are inserted at the end of that line. Items can be omitted 
from the end of the list, implying use of the default values. Also, a value of zero for t ( c ) results 
in two null bytes per tab (character). The former may be needed for C programs, the latter for 
files like /etc/passwd. Because terminal behavior varies according to the specific characters 
printed and the load on a system, the user may have to experiment with these values to get cor¬ 
rect output. The -d option exists only as a last resort for those few cases that do not otherwise 
print properly. For example, the file /etc/passwd may be printed using -d3,30,5. The value 
-d0,l is a good one to use for C programs that have many levels of indentation. 

Note that the delay control interacts heavily with the prevailing carriage return and line-feed 
delays. The stty{ 1) modes nlO cr2 or nlO cr3 are recommended for most uses. 

300 can be used with the nroff -s flag or rd requests, when it is necessary to insert paper manually or 
change fonts in the middle of a document. Instead of hitting the return key in these cases, you must use the 
line-feed key to get any response. 

In many (but not all) cases, the following sequences are equivalent: 

nroff -T300 files ... and nroff files ... I 300 
nroff -T300-12 files ... and nroff files ... I 300 +12 

The use of 300 can thus often be avoided unless special delays or options are required; in a few cases, how¬ 
ever, the additional movement optimization of 300 may produce better-aligned output. 
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The neqn names of, and resulting output for, the Greek and special characters supported by 300 are shown 
in greek( 5). 

SEE ALSO 

450(1), eqn(l), graph(lG), mesg(l), nroff(l), stty(l), tabs(l), tbl(l), tplot(lG), greek(5). 

BUGS 

Some special characters cannot be correctly printed in column 1 because the print head cannot be moved to 
the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction-feed platen instead of a forms tractor; 
although good enough for drafts, the latter has a tendency to slip when reversing direction, distorting Greek 
characters and misaligning the first line of text after one or more reverse line-feeds. 
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NAME 

450 - handle special functions of the DASI 450 terminal 

SYNOPSIS 

450 

DESCRIPTION 

450 supports special functions of, and optimizes the use of, the DASI 450 terminal, or any terminal that is 
functionally identical, such as the DIABLO 1620 or XEROX 1700. It converts half-line forward, half-line 
reverse, and full-line reverse motions to the correct vertical motions. It also attempts to draw Greek letters 
and other special symbols in the same manner as 500(1). 450 can be used to print equations neatly, in the 
sequence: 

neqn file ... I nroff I 450 

WARNING: make sure that the PLOT switch on your terminal is ON before 450 is used. The SPACING 
switch should be put in the desired position (either 10- or 12-pitch). In either case, vertical spacing is 6 
lines/inch, unless dynamically changed to 8 lines per inch by an appropriate escape sequence. 

450 can be used with the nroff -s flag or ,rd requests, when it is necessary to insert paper manually or 
change fonts in the middle of a document. Instead of hitting the return key in these cases, you must use the 
line-feed key to get any response. 

In many (but not all) cases, the use of 450 can be eliminated in favor of one of the following: 

nroff -T450 files ... 
or 

nroff -T450-12 files ... 

The use of 450 can thus often be avoided unless special delays or options are required; in a few cases, how¬ 
ever, the additional movement optimization of 450 may produce better-aligned output. 

The neqn names of, and resulting output for, the Greek and special characters supported by 450 are shown 
in greek( 5). 

SEE ALSO 

300(1), eqn(l), graph(lG), mesg(l), nroff(l), stty(l), tabs(l), tbl(l), tplot(lG), greek(5). 

BUGS 

Some special characters cannot be correctly printed in column 1 because the print head cannot be moved to 
the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction-feed platen instead of a forms tractor; 
although good enough for drafts, the latter has a tendency to slip when reversing direction, distorting Greek 
characters and misaligning the first line of text after one or more reverse line-feeds. 
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NAME 

4014 - paginator for the Tektronix 4014 terminal 
SYNOPSIS 

4014 [ -t ] [ -n ] [ -cN ] [ -pL ] [ file ] 

DESCRIPTION 

The output of 4014 is intended for a Tektronix 4014 terminal; 4014 arranges for 66 lines to fit on the 
screen, divides the screen into N columns, and contributes an eight-space page offset in the (default) 
single-column case. Tabs, spaces, and backspaces are collected and plotted when necessary. TELETYPE nh 

Teletypewriter Model 37 half- and reverse-line sequences are interpreted and plotted. At the end of each 
page, 4014 waits for a new-line (empty line) from the keyboard before continuing on to the next page. In 
this wait state, the command land will send the and to the shell. 

The command line options are: 

-t Don't wait between pages (useful for directing output into a file). 

-n Start printing at the current cursor position and never erase the screen. 

-c N Divide the screen into N columns and wait after the last column. 

-pL Set page length to L; L accepts the scale factors i (inches) and 1 (lines); default is lines. 

SEE ALSO 

pr( 1), tc(l), troffd). 
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NAME 

acctcom - search and print process accounting file(s) 
SYNOPSIS 

acctcom [ [ options ] [ file ] ] . .. 


DESCRIPTION 

Acctcom reads file, the standard input, or /usr/adm/pacct, in the form described by acct(A) and writes 
selected records to the standard output. Each record represents the execution of one process. The output 
shows the COMMAND NAME, USER, TTYNAME, START TIME, END TIME, REAL (SEC), CPU (SEC), 
MEAN SIZE(K), and optionally, F (the, fork!exec flag: 1 for fork without exec ) and STAT (the system exit 
status). 


The command name is prepended with a # if it was executed with super-user privileges. If a process is not 
associated with a known terminal, a ? is printed in the TTYNAME field. 

If no files are specified, and if the standard input is associated with a terminal or /dev/null (as is the case 
when using & in the shell), /usr/adm/pacct is read, otherwise the standard input is read. 

If any file arguments are given, they are read in their respective order. Each file is normally read forward, 
i.e., in chronological order by process completion time. The file /usr/adm/pacct is usually the current file 
to be examined; a busy system may need several such files of which all but the current file are found in 
/usr/adm/pacct?. The options are: 


-b 

-f 

-h 


-k 

-m 

-r 

-t 

-v 

-1 line 
-u user 


-g group 

-d mm/dd 

-s time 
-e time 
-S time 
-E time 
-n pattern 

-O ofile 

-H factor 

-O sec 
-C sec 


Read backwards, showing latest commands first. 

Print the fork I exec flag and system exit status columns in the output. 

Instead of mean memory size, show the fraction of total available CPU time consumed by the 
process during its execution. This “hog factor” is computed as: 

(total CPU time)/(elapsed time). 

Print columns containing the I/O counts in the output. 

Instead of memory size, show total kcore-minutes. 

Show mean core size (the default). 

Show CPU factor (user time/(system-time + user-time). 

Show separate system and user CPU times. 

Exclude column headings from the output. 

Show only processes belonging to terminal /d e\/line. 

Show only processes belonging to user that may be specified by: a user ID, a login name that 
is then converted to a user ID, a # which designates only those processes executed with 
super-user privileges, or ? which designates only those processes associated with unknown 
user IDs. 

Show only processes belonging to group. The group may be designated by either the group 
ID or group name. 

Any time arguments following this flag are assumed to occur on the given month mm and 
the day dd rather than during last 24 hours. This is needed for looking at old files. 

Select processes existing at or after time , given in the format hr [: min [: sec ] ]. 

Select processes existing at or before time. 

Select processes starting at or after time . 

Select processes ending at or before time. 

Show only commands matching pattern that may be a regular expression as in ed( 1) except 
that + means one or more occurrences. 

Copy selected process records in the input data format to ofile ; supress standard output print¬ 
ing. 

Show only processes that exceed factor, where factor is the ‘ ‘hog factor’ ’ as explained in 
option -h above. 

Show only processes with CPU system time exceeding sec seconds. 

Show only processes with total CPU time, system plus user, exceeding sec seconds. 
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Listing options together has the effect of a logical and. 

FILES 

/etc/passwd 

/usr/adm/pacct 

/etc/group 

SEE ALSO 

ps(l), su(l), acct(2), acct(4), utmp(4). 

acct(lM), acctcms(lM), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), fwtmp(lM), runacct(lM) 
in the UNIX System Administrator’s Manual. 

BUGS 

Acctcom only reports on processes that have terminated; use ps( 1) for active processes. If time exceeds the 
present time and option -d is not used, then time is interpreted as occurring on the previous day. 
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NAME 

adb - absolute debugger 

SYNOPSIS 

adb [-w] [ objfil [ corfil ) ] 

DESCRIPTION 

Adb is a general purpose debugging program. It may be used to examine files and to provide a controlled 
environment for the execution of UNIX System programs. 

Objfil is normally an executable program file, preferably containing a symbol table; if not then the symbolic 
features of adb cannot be used although the file can still be examined. The default for objfil is a.out. 
Corfil is assumed to be a core image file produced after executing objfil ; the default for corfil is core. 

Requests to adb are read from the standard input and responses are to the standard output. If the -w flag is 
present then both objfil and corfil are created if necessary and opened for reading and writing so that files 
can be modified using adb. Adb ignores QUIT; INTERRUPT causes return to the next adb command. 

In general requests to adb are of the form 

[ address ] [, count ] [ command ] [; ] 

If address is present then dot is set to address. Initially dot is set to 0. For most commands count 
specifies how many times the command will be executed. The default count is 1. Address and count are 
expressions. 

The interpretation of an address depends on the context it is used in. If a subprocess is being debugged then 
addresses are interpreted in the usual way in the address space of the subprocess. For further details of 
address mapping see ADDRESSES. 

EXPRESSIONS 

. The value of dot. 

+ The value of dot incremented by the current increment. 

The value of dot decremented by the current increment. 

" The last address typed. 

integer An octal number if integer begins with a 0; a hexadecimal number if preceded by #; otherwise a 
decimal number. 

in teger .fraction 

A 32 bit floating point number. 

'cccc' The ASCII value of up to 4 characters. \ may be used to escape a '. 

< name The value of name, which is either a variable name or a register name. Adb maintains a number of 
variables (see VARIABLES) named by single letters or digits. If name is a register name then the 
value of the register is obtained from the system header in corfil. The register names are rO ... r5 

sp pc ps. 

symbol A symbol is a sequence of upper or lower case letters, underscores or digits, not starting with a 
digit. The value of the symbol is taken from the symbol table in objfil. An initial or ~ will be 
prefixed to symbol if needed. 

_ symbol 

In C, the ‘ ‘true name’ ’ of an external symbol begins with . It may be necessary to utter this name 
to distinguish it from internal or hidden variables of a program. 

routine .name 

The address of the variable name in the specified C routine. Both routine and name are symbols. 
If name is omitted the value is the address of the most recently activated C stack frame corre¬ 
sponding to routine. 
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(exp ) The value of the expression exp. 

Monadic operators: 

*exp The contents of the location addressed by exp in corfil. 

@exp The contents of the location addressed by exp in objfil. 

-exp Integer negation. 

~exp Bitwise complement. 

Dyadic operators are left associative and are less binding than monadic operators. 
el +e2 Integer addition. 
el —e2 Integer subtraction. 
el *e2 Integer multiplication. 
el % e2 Integer division. 
el &e2 Bitwise conjunction. 
el I e2 Bitwise disjunction. 
el #e2 El rounded up to the next multiple of e2. 

COMMANDS 

Most commands consist of a verb followed by a modifier or list of modifiers. The following verbs are 
available. (The commands ? and / may be followed by *; see ADDRESSES for further details.) 

?/ Locations starting at address in objfil are printed according to the format/, dot is incremented by 
the sum of the increments for each format letter (q.v.). 

If Locations starting at address in corfil are printed according to the format / and dot is incremented 
as for ?. 

=/ The value of address itself is printed in the styles indicated by the format /. (For i format ? is 
printed for the parts of the instruction that reference subsequent words.) 

A format consists of one or more characters that specify a style of printing. Each format character may be 
preceded by a decimal integer that is a repeat count for the format character. While stepping through a for¬ 
mat dot is incremented by the amount given for each format letter. If no format is given then the last for¬ 
mat is used. The format letters available are as follows: 

o 2 Print 2 bytes in octal. All octal numbers output by adb are preceded by 0. 

O 4 Print 4 bytes in octal, 

q 2 Print in signed octal. 

Q 4 Print long signed octal, 

d 2 Print in decimal. 

D 4 Print long decimal, 

x 2 Print 2 bytes in hexadecimal. 

X 4 Print 4 bytes in hexadecimal, 

u 2 Print as an unsigned decimal number. 

U 4 Print long unsigned decimal, 
f 4 Print the 32 bit value as a floating point number. 

F 8 Print double floating point, 

b 1 Print the addressed byte in octal, 

c 1 Print the addressed character. 

C 1 Print the addressed character using the following escape convention. Character values 
000 to 040 are printed as @ followed by the corresponding character in the range 0100 to 
0140. The character @ is printed as @ @. 
s n Print the addressed characters until a zero character is reached. 
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S n Print a string using the @ escape convention, n is the length of the string including its 
zero terminator. 

Y 4 Print 4 bytes in date format (see dime CSC)). 

i n Print as PDP-11 instructions, n is the number of bytes occupied by the instruction. This 

style of printing causes variables 1 and 2 to be set to the offset parts of the source and 
destination respectively. 

a 0 Print the value of dot in symbolic form. Symbols are checked to ensure that they have an 
appropriate type as indicated below. 

/ local or global data symbol 
? local or global text symbol 
= local or global absolute symbol 

p 2 Print the addressed value in symbolic form using the same rules for symbol lookup as a. 

t 0 When preceded by an integer tabs to the next appropriate tab stop. For example, 8t 

moves to the next 8-space tab stop, 
r 0 Print a space, 

n 0 Print a new-line. 

0 Print the enclosed string. 

Dot is decremented by the current increment. Nothing is printed. 

+ Dot is incremented by 1. Nothing is printed. 

- Dot is decremented by 1. Nothing is printed. 

new-line 

Repeat the previous command with a count of 1. 

[?/]l value mask 

Words starting at dot are masked with mask and compared with value until a match is found. If L 
is used then the match is for 4 bytes at a time instead of 2. If no match is found then dot is 
unchanged; otherwise dot is set to the matched location. If mask is omitted then -1 is used. 

[?/]w value... 

Write the 2-byte value into the addressed location. If the command is W, write 4 bytes. Odd 
addresses are not allowed when writing to the subprocess address space. 

[?/]m bl el //[?/] 

New values for (bl, el,fl ) are recorded. If less than three expressions are given then the remain¬ 
ing map parameters are left unchanged. If the ? or / is followed by * then the second segment 
( b2 , e2 ,f2) of the mapping is changed. If the list is terminated by ? or / then the file ( objfil or 
corfil respectively) is used for subsequent requests. (So that, for example, /m? will cause / to refer 
to objfil.) 

>name Dot is assigned to the variable or register named. 

! A shell is called to read the rest of the line following !. 

Smodifier 

Miscellaneous commands. The available modifiers are; 

</ Read commands from the file/ and return. 

>/ Send output to the file/, which is created if it does not exist, 
r Print the general registers and the instruction addressed by pc. Dot is set to pc. 

f Print the floating registers in single or double length. If the floating point status of ps is 

set to double (0200 bit) then double length is used anyway, 
b Print all breakpoints and their associated counts and commands. 

a ALGOL 68 stack backtrace. If address is given then it is taken to be the address of the 

current frame (instead of r4). If count is given then only the first count frames are 
printed. 
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c C stack backtrace. If address is given then it is taken as the address of the current frame 

(instead of r5). If C is used then the names and (16 bit) values of all automatic and static 
variables are printed for each active function. If count is given then only the first count 
frames are printed. 

e The names and values of external variables are printed, 

w Set the page width for output to address (default 80). 

s Set the limit for symbol matches to address (default 255). 

o All integers input are regarded as octal, 

d Reset integer input as described in EXPRESSIONS. 

q Exit from adb. 

v Print all non zero variables in octal, 

m Print the address map. 

•.modifier 

Manage a subprocess. Available modifiers are: 

be Set breakpoint at address. The breakpoint is executed count-1 times before causing a 
stop. Each time the breakpoint is encountered the command c is executed. If this com¬ 
mand sets dot to zero then the breakpoint causes a stop. 

d Delete breakpoint at address. 

r Run objfil as a subprocess. If address is given explicitly then the program is entered at 

this point; otherwise the program is entered at its standard entry point, count specifies 
how many breakpoints are to be ignored before stopping. Arguments to the subprocess 
may be supplied on the same line as the command. An argument starting with < or > 
causes the standard input or output to be established for the command. All signals are 
turned on on entry to the subprocess. 

cs The subprocess is continued with signal s (see signal (2)). If address is given then the 
subprocess is continued at this address. If no signal is specified then the signal that 
caused the subprocess to stop is sent. Breakpoint skipping is the same as for r. 

Si As for c except that the subprocess is single stepped count times. If there is no current 
subprocess then objfil is run as a subprocess as for r. In this case no signal can be sent; 
the remainder of the line is treated as arguments to the subprocess. 

k The current subprocess, if any, is terminated. 

VARIABLES 

Adb provides a number of variables. Named variables are set initially by adb but are not used subse¬ 
quently. Numbered variables are reserved for communication as follows. 

0 The last value printed. 

1 The last offset part of an instruction source. 

2 The previous value of variable 1. 

On entry the following are set from the system header in the corfil. If corfil does not appear to be a core 
file then these values are set from objfil. 

b The base address of the data segment, 

d The data segment size, 

e The entry point. 

m The “magic” number (0405, 0407, 0410 or 0411). 
s The stack segment size, 

t The text segment size. 

ADDRESSES 

The address in a file associated with a written address is determined by a mapping associated with that file. 
Each mapping is represented by two triples (bl, el, fl) and (b2, e2,J2) and th e file address corresponding 
to a written address is calculated as follows: 
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bl<address<el => file address=address+fl-bl 
otherwise 

b2<address<e2 => file address=ciddress+f2-b2, 

otherwise, the requested address is not legal. In some cases (e.g. for programs with separated I and D 
space) the two segments for a file may overlap. If a ? or / is followed by an * then only the second triple is 
used. 

The initial setting of both mappings is suitable for normal a.out and core files. If either file is not of the 
kind expected then, for that file, bl is set to 0, el is set to the maximum file size and fl is set to 0; in this 
way the whole file can be examined with no address translation. 

In order for adb to be used on large files all appropriate values are kept as signed 32 bit integers. 

FILES 

/dev/mem 
/dev/s wap 
a.out 
core 

SEE ALSO 

ptrace(2), a.out(4), core(4). 

DIAGNOSTICS 

“Adb” when there is no current command or format. Comments about inaccessible files, syntax errors, 
abnormal termination of commands, etc. Exit status is 0, unless last command failed or returned nonzero 
status. 

BUGS 

A breakpoint set at the entry point is not effective on initial entry to the program. 

When single stepping, system calls do not count as an executed instruction. 

Local variables whose names are the same as an external variable may foul up the accessing of the external. 


Page 5 



ADMIN (1) 


ADMIN(l) 


NAME 

admin - create and administer SCCS files 
SYNOPSIS 

admin [-n] [-i[name]] [-rrel] [-tfname]] [-fflag[flag-val]] [-dflag[flag-val]] [-alogin] [-elogin] 
[-m[mrlist]] [-y[comment]] [-h] [-z] files 

DESCRIPTION 

Admin is used to create new SCCS files and change parameters of existing ones. Arguments to admin, 
which may appear in any order, consist of keyletter arguments, which begin with -, and named files (note 
that SCCS file names must begin with the characters s.). If a named file doesn’t exist, it is created, and its 
parameters are initialized according to the specified keyletter arguments. Parameters not initialized by a 
keyletter argument are assigned a default value. If a named file does exist, parameters corresponding to 
specified keyletter arguments are changed, and other parameters are left as is. 

If a directory is named, admin behaves as though each file in the directory were specified as a named file, 
except that non-SCCS files (last component of the path name does not begin with s.) and unreadable files 
are silently ignored. If a name of - is given, the standard input is read; each line of the standard input is 
taken to be the name of an SCCS file to be processed. Again, non-SCCS files and unreadable files are 
silently ignored. 

The keyletter arguments are as follows. Each is explained as though only one named file is to be processed 
since the effects of the arguments apply independently to each named file. 

-n This keyletter indicates that a new SCCS file is to be created. 

-i [name\ The name of a file from which the text for a new SCCS file is to be taken. The text 

constitutes the first delta of the file (see -r keyletter for delta numbering scheme). 
If the i keyletter is used, but the file name is omitted, the text is obtained by read¬ 
ing the standard input until an end-of-file is encountered. If this keyletter is omit¬ 
ted, then the SCCS file is created empty. Only one SCCS file may be created by an 
admin command on which the i keyletter is supplied. Using a single admin to cre¬ 
ate two or more SCCS files require that they be created empty (no -i keyletter). 
Note that the -i keyletter implies the -n keyletter. 

-rrel The release into which the initial delta is inserted. This keyletter may be used 

only if the -i keyletter is also used. If the -r keyletter is not used, the initial delta 
is inserted into release 1. The level of the initial delta is always 1 (by default ini¬ 
tial deltas are named 1.1). 

-t [name] The name of a file from which descriptive text for the SCCS file is to be taken. If 

the -t keyletter is used and admin is creating a new SCCS file (the -n and/or -i 
keyletters also used), the descriptive text file name must also be supplied. In the 
case of existing SCCS files: (1) a -t keyletter without a file name causes removal of 
descriptive text (if any) currently in the SCCS file, and (2) a -t keyletter with a file 
name causes text (if any) in the named file to replace the descriptive text (if any) 
currently in the SCCS file. 

-{flag This keyletter specifies a flag, and, possibly, a value for the flag, to be placed in 

the SCCS file. Several f keyletters may be supplied on a single admin command 
line. The allowable flags and their values are; 

b Allows use of the -b keyletter on a get{ 1) command to create branch deltas. 

c ceil The highest release (i.e., “ceiling”), a number less than or equal to 9999, which 

may be retrieved by a get(l) command for editing. The default value for an 
unspecified c flag is 9999. 

{floor The lowest release (i.e., “floor”), a number greater than 0 but less than 9999, 
which may be retrieved by a get{ 1) command for editing. The default value for an 
unspecified f flag is 1. 
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dSID The default delta number (SID) to be used by a get) 1) command. 

i Causes the "No id keywords (ge6)" message issued by get(l) or delta))) to be 

treated as a fatal error. In the absence of this flag, the message is only a warning. 
The message is issued if no SCCS identification keywords (see get{ 1)) are found in 
the text retrieved or stored in the SCCS file. 

j Allows concurrent get{ 1) commands for editing on the same SID of an SCCS file. 

This allows multiple concurrent updates to the same version of the SCCS file. 

1 list A list of releases to which deltas can no longer be made (get -e against one of 
these “locked” releases fails). The list has the following syntax: 

<list> ::= <range> | <list> , <range> 

<range> ::= RELEASE NUMBER | a 

The character a in the list is equivalent to specifying all releases for the named 
SCCS file. 


n Causes delta))) to create a “null” delta in each of those releases (if any) being 

skipped when a delta is made in a new release (e.g., in making delta 5.1 after delta 
2.7, releases 3 and 4 are skipped). These null deltas serve as “anchor points” so 
that branch deltas may later be created from them. The absence of this flag causes 
skipped releases to be non-existent in the SCCS file preventing branch deltas from 
being created from them in the future. 

q text User definable text substituted for all occurrences of the %Q% keyword in SCCS 
file text retrieved by get( 1). 

m mod Module name of the SCCS file substituted for all occurrences of the %M% key¬ 
word in SCCS file text retrieved by get( 1). If the m flag is not specified, the value 
assigned is the name of the SCCS file with the leading s. removed. 

t type Type of module in the SCCS file substituted for all occurrences of %Y% keyword 
in SCCS file text retrieved by get( 1). 

\[pgm] Causes delta))) to prompt for Modification Request (MR) numbers as the reason 
for creating a delta. The optional value specifies the name of an MR number valid¬ 
ity checking program (see delta) 1)). (If this flag is set when creating an SCCS file, 
the m keyletter must also be used even if its value is null). 


-d flag 


Hist 


-alogin 


-elogin 


Causes removal (deletion) of the specified flag from an SCCS file. The -d keylet¬ 
ter may be specified only when processing existing SCCS files. Several -d keylet- 
ters may be supplied on a single admin command. See the -f keyletter for allow¬ 
able flag names. 

A list of releases to be “unlocked”. See the -f keyletter for a description of the 1 
flag and the syntax of a list. 

A login name, or numerical UNIX System group ID, to be added to the list of users 
which may make deltas (changes) to the SCCS file. A group ID is equivalent to 
specifying all login names common to that group ID. Several a keyletters may be 
used on a single admin command line. As many logins , or numerical group IDs, 
as desired may be on the list simultaneously. If the list of users is empty, then 
anyone may add deltas. 

A login name, or numerical group ID, to be erased from the list of users allowed to 
make deltas (changes) to the SCCS file. Specifying a group ID is equivalent to 
specifying all login names common to that group ID. Several e keyletters may be 
used on a single admin command line. 
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-y [comment] The comment text is inserted into the SCCS file as a comment for the initial delta 

in a manner identical to that of delta(l). Omission of the -y keyletter results in a 
default comment line being inserted in the form: 

date and time created YYlMMlDD HH.MM.SS by login 

The -y keyletter is valid only if the -i and/or -n keyletters are specified (i.e., a 
new SCCS file is being created). 

-m [mrlist] The list of Modification Requests (MR) numbers is inserted into the SCCS file as 

the reason for creating the initial delta in a manner identical to delta) 1). The v flag 
must be set and the MR numbers are validated if the v flag has a value (the name of 
an MR number validation program). Diagnostics will occur if the v flag is not set 
or MR validation fails. 

-h Causes admin to check the structure of the SCCS file (see sccsfile) 5)), and to com¬ 

pare a newly computed check-sum (the sum of all the characters in the SCCS file 
except those in the first line) with the check-sum that is stored in the first line of 
the SCCS file. Appropriate error diagnostics are produced. 

This keyletter inhibits writing on the file, so that it nullifies the effect of any other 
keyletters supplied, and is, therefore, only meaningful when processing existing 
files. 

-z The SCCS file check-sum is recomputed and stored in the first line of the SCCS file 

(see -h, above). 

Note that use of this keyletter on a truly corrupted file may prevent future detec¬ 
tion of the corruption. 

FILES 

The last component of all SCCS file names must be of the form s .file-name. New SCCS files are given mode 
444 (see chmod( 1)). Write permission in the pertinent directory is, of course, required to create a file. All 
writing done by admin is to a temporary x-file, called x.file-name, (see get) 1)), created with mode 444 if the 
admin command is creating a new SCCS file, or with the same mode as the SCCS file if it exists. After suc¬ 
cessful execution of admin , the SCCS file is removed (if it exists), and the x-file is renamed with the name 
of the SCCS file. This ensures that changes are made to the SCCS file only if no errors occurred. 

It is recommended that directories containing SCCS files be mode 755 and that SCCS files themselves be 
mode 444. The mode of the directories allows only the owner to modify SCCS files contained in the direc¬ 
tories. The mode of the SCCS files prevents any modification at all except by SCCS commands. 

If it should be necessary to patch an SCCS file for any reason, the mode may be changed to 644 by the 
owner allowing use of ed( 1). Care must be taken! The edited file should always be processed by an admin 
-h to check for corruption followed by an admin -z to generate a proper check-sum. Another admin -h is 
recommended to ensure the SCCS file is valid. 

Admin also makes use of a transient lock file (called z .file-name), which is used to prevent simultaneous 
updates to the SCCS file by different users. See get) 1) for further information. 

SEE ALSO 

delta(l), ed(l), get(l), help(l), prs(l), what(l), sccsfile(4). 

Source Code Control System User’s Guide in the UNIX System User’s Guide. 

DIAGNOSTICS 

Use help) 1) for explanations. 
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NAME 

ar - archive and library maintainer for portable archives 

SYNOPSIS 

ar key [ posname ] afile name ... 

DESCRIPTION 

Ar maintains groups of files combined into a single archive file. Its main use is to create and update library 
files as used by the link editor. It can be used, though, for any similar purpose. 

When ar creates an archive, it creates headers in a format that is portable across all machines. The portable 
archive format and structure is described in detail in ar( 4). The archive symbol table (described in ar( 4)) is 
used by the link editor (ld( 1)) to effect multiple passes over libraries of object files in an efficient manner. 
Whenever the ar{ 1) command is used to create or update the contents of an archive, the symbol table is 
rebuilt. The symbol table can be forced to be rebuilt by the s option described below. 

Key is one character from the set drqtpmx, optionally concatenated with one or more of vuaibcls. Afile is 
the archive file. The names are constituent files in the archive file. The meanings of the key characters are: 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. If the optional character u is used with r, then only 

those files with modified dates later than the archive files are replaced. If an optional positioning 
character from the set abi is used, then the posname argument must be present and specifies that 
new files are to be placed after (a) or before (b or i) posname. Otherwise new files are placed at 
the end. 

q Quickly append the named files to the end of the archive file. Optional positioning characters are 

invalid. The command does not check whether the added members are already in the archive. 
Useful only to avoid quadratic behavior when creating a large archive piece-by-piece. 

t Print a table of contents of the archive file. If no names are given, all files in the archive are 

tabled. If names are given, only those files are tabled. 

p Print the named files in the archive. 

m Move the named files to the end of the archive. If a positioning character is present, then the 
posname argument must be present and, as in r, specifies where the files are to be moved. 

x Extract the named files. If no names are given, all files in the archive are extracted. In neither case 

does x alter the archive file. 

v Verbose. Under the verbose option, ar gives a file-by-file description of the making of a new 

archive file from the old archive and the constituent files. When used with t, it gives a long listing 
of all information about the files. When used with x, it precedes each file with a name. 

c Create. Normally ar will create afile when it needs to. The create option suppresses the normal 

message that is produced when afile is created. 

1 Local. Normally ar places its temporary files in the directory /tmp. This option causes them to be 

placed in the local directory. 

s Symbol table creation. Force the regeneration of the archive symbol table even if ar( 1) is not 

invoked with a command which will modify the archive contents. This command is useful to 
restore the archive symbol table after the strip( 1) command has been used on the archive. 

FILES 

/tmp/ar* temporaries 

SEE ALSO 

arcv(l), ld( 1), lorder(l), a.out(4), ar(4). 

BUGS 

If the same file is mentioned twice in an argument list, it may be put in the archive twice. 
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NAME 

ar - archive and library maintainer 

SYNOPSIS 

ar key [ posname ] afile name ... 

DESCRIPTION 

Ar maintains groups of files combined into a single archive file. Its main use is to create and update library 
files as used by the link editor. It can be used, though, for any similar purpose. 

When ar creates an archive, it always creates the header in the format of the local system. A conversion 
program exists to convert PDP-11 archives to pre-UNIX System 5.0 VAX-11/780 archive format (see 
arcv (\)). Another conversion program, convert ( 1), exists on the VAX and 3B20S to convert archives from 
the pre-UNIX System 5.0 format to the "common" archive format described in ar( 4). Individual files are 
inserted without conversion into the archive file. 

Key is one character from the set drqtpmx, optionally concatenated with one or more of vuaibcl. Afile is 
the archive file. The names are constituent files in the archive file. The meanings of the key characters are: 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. If the optional character u is used with r, then only 

those files with modified dates later than the archive files are replaced. If an optional positioning 
character from the set abi is used, then the posname argument must be present and specifies that 

new files are to be placed after (a) or before (b or i) posname. Otherwise new files are placed at 

the end. 

q Quickly append the named files to the end of the archive file. Optional positioning characters are 

invalid. The command does not check whether the added members are already in the archive. 
Useful only to avoid quadratic behavior when creating a large archive piece-by-piece. 

t Print a table of contents of the archive file. If no names are given, all files in the archive are 

tabled. If names are given, only those files are tabled. 

p Print the named files in the archive. 

m Move the named files to the end of the archive. If a positioning character is present, then the 
posname argument must be present and, as in r, specifies where the files are to be moved. 

x Extract the named files. If no names are given, all files in the archive are extracted. In neither case 

does x alter the archive file. 

v Verbose. Under the verbose option, ar gives a file-by-file description of the making of a new 

archive file from the old archive and the constituent files. When used with t, it gives a long listing 
of all information about the files. When used with x, it precedes each file with a name. 

c Create. Normally ar will create afile when it needs to. The create option suppresses the normal 

message that is produced when afile is created. 

1 Local. Normally ar places its temporary files in the directory /tmp. This option causes them to be 

placed in the local directory. 

FILES 

/tmp/v* temporaries 

SEE ALSO 

arcv(l), ld(l), lorder(l), ar(4). 

BUGS 

If the same file is mentioned twice in an argument list, it may be put in the archive twice. 
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NAME 

arcv - convert archive files from PDP-11 to common archive format 

SYNOPSIS 

arcv infile outfile 

DESCRIPTION 

Arcv converts source archive files from the PDP-11 format to the UNIX System 5.0 portable archive format. 
The input archive file infile is converted to an equivalent output archive file outfile . Note that there is no 
conversion of the members of the input archive file. 

FILES 

/tmp/arcv* 

SEE ALSO 

ar(l), convert(l), ar(4). 
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NAME 

as - common assembler 

SYNOPSIS 

as [-o objfile] [-n] [-m] [-R] [-r] [-[bwl]] [-V] file-name 
DESCRIPTION 

The as command assembles the named file. The following flags may be specified in any order: 

-o objfile Output of assembly is put in objfile . By default, the output file name is formed by removing the 
.s suffix, if there is one, from the input file name and appending a .o suffix. 

-n Turns off long/short address optimization. By default, address optimization takes place. 

-m Runs the m4 macro pre-processor on the input to the assembler. 

-R Instructs the assembler to delete (unlink) the input file after assembly is completed. This option 

is off by default. 

-r For the VAX version of the common assembler only. This option instructs the assembler to place 

all assembled data (normally placed in the .data section) into the .text section. This option effec¬ 
tively disables the .data pseudo operation. This option is off by default. 

-[bwl] For the VAX version of the common assembler only. This option instructs the assembler to cre¬ 
ate byte (b) , halfword (w) or long (1) displacements for undefined symbols. The default value 
for this option is long (1) displacements. 

-V Causes the version number of the assembler being run to be written on standard error. 

FILES 

/usr/tmp/as[ I -6]XXXXXX temporary files 
SEE ALSO 

ld(l), m4(l), nm(l), strip(l), a.out(4). 

DIAGNOSTICS 

If the input file cannot be read, the assembly will terminate with the message "Unable to open input file". If 
assembly errors are detected the following information is written to standard error: the input file name, line 
number where the error occurred in the assembly code, a (hopefully) descriptive message of the problem, 
and, if the input file was produced by the C compiler (see cc(l)) the line number in the C program that gen¬ 
erated the erroneous code. 

CAVEATS 

Those running the assembler explicitly should take note of some possible pitfalls: 

If the -m ( m4 macro pre-processor invocation) option is used, keywords for m4 (see m4( I)) cannot 
be used as symbols (variables, functions, labels) in the input file since m4 cannot determine which are 
assembler symbols and which are real m4 macros. 

BUGS 

The .align assembler directive is not guaranteed to work in the .text section when optimization is per¬ 
formed. 

Arithmetic expressions may only have one forward referenced symbol per expression. 
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NAME 

as - assembler for PDP-11 

SYNOPSIS 

as [ — ] [ —o objfile ] file ... 

DESCRIPTION 

As assembles the concatenation of the named files. If the optional first argument - is used, all undefined 
symbols in the assembly are treated as global. 

The output of the assembly is left on the file objfile ; if that is omitted, a.out is used. It is executable if no 
errors occurred during the assembly, and if there were no unresolved external references. 

FILES 

/lib/as2 pass 2 of the assembler 

/tmp/atm[l-3]? temporary 

a.out object 

SEE ALSO 

adb(l), ld(l), nm(l), a.out(4). 

UNIX System Assembler Manual by D. M. Ritchie. 

DIAGNOSTICS 

If the name chosen for the output file is of the form *?.[cs], the assembler issues an appropriate complaint 
and quits. When an input file cannot be read, its name followed by a question mark is typed and assembly 
ceases. When syntactic or semantic errors occur, a single-character diagnostic is typed out together with 
the line number and the file name in which it occurred. Errors in pass 1 cause cancellation of pass 2. The 
possible errors are: 

) Parentheses error 

] Parentheses error 

< String not terminated properly 

* Indirection used illegally 

. Illegal assignment to . 

a Error in address 

b Branch instruction is odd or too remote 

e Error in expression 

f Error in local (f or b) type symbol 

g Garbage (unknown) character 

i End of file inside an . if 

m Multiply-defined symbol as label 

o Word quantity assembled at odd address 

p . different in pass 1 and 2 

r Relocation error 

u Undefined symbol 

x Syntax error 

BUGS 

Syntax errors can cause incorrect line numbers in subsequent diagnostics. 
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NAME 

asa - interpret ASA carriage control characters 

SYNOPSIS 

asa [ files] 

DESCRIPTION 

Asa interprets the output of FORTRAN programs that utilize ASA carriage control characters. It processes 
either the files whose names are given as arguments or the standard input if no file names are supplied. The 
first character of each line is assumed to be a control character; their meanings are; 

(blank) single new line before printing 

0 double new line before printing 

1 new page before printing 

+ overprint previous line. 

Lines beginning with other than the above characters are treated as if they began with ' '. The first charac¬ 
ter of a line is not printed. If any such lines appear, an appropriate diagnostic will appear on standard error. 
This program forces the first line of each input file to start on a new page. 

To correctly view the output of FORTRAN programs which use ASA carriage control characters, asa could 
be used as a filter thusly: 


a.out I asa I lpr 


and the output, properly formatted and pagenated, would be directed to the line printer. FORTRAN output 
sent to a file could be viewed by; 


asa file 


SEE ALSO 

efl(l), f77(l), fsplit(l), ratfor(l). 
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NAME 

awk - pattern scanning and processing language 
SYNOPSIS 

awk [ -Fc ] [ prog ] [ parameters ] [ files ] 

DESCRIPTION 

Awk scans each input file for lines that match any of a set of patterns specified in prog. With each pattern 
in prog there can be an associated action that will be performed when a line of a file matches the pattern. 
The set of patterns may appear literally as prog, or in a file specified as -f file. The prog string should be 
enclosed in single quotes (') to protect it from the shell. 

Parameters, in the form x=... y=... etc., may be passed to awk. 

Files are read in order; if there are no files, the standard input is read. The file name - means the standard 
input. Each line is matched against the pattern portion of every pattern-action statement; the associated 
action is performed for each matched pattern. 

An input line is made up of fields separated by white space. (This default can be changed by using FS, see 
below). The fields are denoted $1, $2, ...; $0 refers to the entire line. 

A pattern-action statement has the form; 

pattern { action } 

A missing action means print the line; a missing pattern always matches. An action is a sequence of state¬ 
ments. A statement can be one of the following: 

if ( conditional ) statement [ else statement ] 
while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 

break 

continue 

{ [ statement ] ... } 

variable = expression 

print [ expression-list ] [ Expression ] 

printf format [ , expression-list ] [ Expression ] 

next # skip remaining patterns on this input line 

exit # skip the rest of the input 

Statements are terminated by semicolons, new-lines, or right braces. An empty expression-list stands for 
the whole line. Expressions take on string or numeric values as appropriate, and are built using the opera¬ 
tors +, -, *, /, %, and concatenation (indicated by a blank). The C operators ++, —, +=, -=, *=, /=, and 
%= are also available in expressions. Variables may be scalars, array elements (denoted x[i]) or fields. 
Variables are initialized to the null string. Array subscripts may be any string, not necessarily numeric; this 
allows for a form of associative memory. String constants are quoted (")• 

The print statement prints its arguments on the standard output (or on a file if >expr is present), separated 
by the current output field separator, and terminated by the output record separator. The printf statement 
formats its expression list according to the format (see printf{ 3S)). 

The built-in function length returns the length of its argument taken as a string, or of the whole line if no 
argument. There are also built-in functions exp, log, sqrt, and int. The last truncates its argument to an 
integer; substr(s, m, n) returns the n -character substring of ,v that begins at position m. The function 
sprintfifmt, expr, expr ,...) formats the expressions according to the printf( 3S) format given by fmt and 
returns the resulting string. 

Patterns are arbitrary Boolean combinations ( !, I |, &&, and parentheses) of regular expressions and rela¬ 
tional expressions. Regular expressions must be surrounded by slashes and are as in egrep (see grep( 1)). 
Isolated regular expressions in a pattern apply to the entire line. Regular expressions may also occur in 
relational expressions. A pattern may consist of two patterns separated by a comma; in this case, the action 
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is performed for all lines between an occurrence of the first pattern and the next occurrence of the second. 

A relational expression is one of the following: 

expression matchop regular-expression 
expression relop expression 

where a relop is any of the six relational operators in C, and a matchop is either ~ (for contains) or P (for 
does not contain). A conditional is an arithmetic expression, a relational expression, or a Boolean combi¬ 
nation of these. 

The special patterns BEGIN and END may be used to capture control before the first input line is read and 
after the last. BEGIN must be the hist pattern, END the last. 

A single character c may be used to separate the fields by starting the program with: 

BEGIN { FS = c } 
or by using the -Fc option. 

Other variable names with special meanings include NF, the number of fields in the current record; NR, the 
ordinal number of the current record; FILENAME, the name of the current input hie; OFS, the output held 
separator (default blank); ORS, the output record separator (default new-line); and OFMT, the output format 
for numbers (default %.6g). 

EXAMPLES 

Print lines longer than 72 characters: 
length >72 

Print hist two helds in opposite order: 

{ print $2, $1 } 

Add up hist column, print sum and average: 

{ s += $1 } 

END { print "sum is", s, " average is", s/NR } 

Print helds in reverse order: 

{ for (i = NF; i > 0; —i) print $i } 

Print all lines between start/stop pairs: 

/start/, /stop/ 

Print all lines whose hrst held is different from previous one: 

$1 != prev { print; prev = $1 } 

Print hie, filling in page numbers starting at 5: 

/Page/ { $2 = n++; } 

{ print } 

command line: awk -f program n=5 input 

SEE ALSO 

grep(l), lex(l), sed(l). 

Awk-A Pattern Scanning and Processing Language by A. V. Aho, B. W. Kernighan, and P. J. Weinberger. 

BUGS 

Input white space is not preserved on output if helds are involved. 

There are no explicit conversions between numbers and strings. To force an expression to be treated as a 
number add 0 to it; to force it to be treated as a string concatenate the null string (" ") to it. 
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NAME 

banner - make posters 

SYNOPSIS 

banner strings 

DESCRIPTION 

Banner prints its arguments (each up to 10 characters long) in large letters on the standard output. 

SEE ALSO 

echo(l). 
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NAME 

basename, dirname - deliver portions of path names 
SYNOPSIS 

basename string [ suffix ] 
dirname string 

DESCRIPTION 

Basename deletes any prefix ending in / and the suffix (if present in string) from string, and prints the 
result on the standard output. It is normally used inside substitution marks (' ') within shell procedures. 

Dirname delivers all but the last level of the path name in string. 

EXAMPLES 

The following example, invoked with the argument /usr/src/cmd/cat.c, compiles the named file and moves 
the output to a file named cat in the current directory: 

cc $1 

mv a.out 'basename $1 ,c v 

The following example will set the shell variable NAME to /usr/src/cmd: 

NAME= v dirname /usr/src/cmd/cat.c" 

SEE ALSO 

sh(l). 

BUGS 

The basename of / is null and is considered an error. 
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NAME 

be - arbitrary-precision arithmetic language 
SYNOPSIS 

be [ -c ] [ -1 ] [ file ... ] 

DESCRIPTION 

Be is an interactive processor for a language that resembles C but provides unlimited precision arithmetic. 
It takes input from any files given, then reads the standard input. The -1 argument stands for the name of an 
arbitrary precision math library. The syntax for be programs is as follows; L means letter a-z, E means 
expression, S means statement. 

Comments 

are enclosed in /*■ and */. 

Names 

simple variables: L 
array elements: L [ E ] 

The words “ibase”, “obase”, and “scale” 

Other operands 

arbitrarily long numbers with optional sign and decimal point. 

(E) 

sqrt (E) 

length ( E ) number of significant decimal digits 
scale (E ) number of digits right of decimal point 

L ( E , ..., E) 

Operators 

+ -*/%''(% is remainder; * is power) 

++ — (prefix and postfix; apply to names) 

== <= >=!=<> 

= =+ =- =* =/ =% =~ 

Statements 

E 

{ S ; ... ; S } 
if (E) S 
while (E) S 
for ( E ; E ; E ) S 
null statement 
break 
quit 

Function definitions 

define L ( L ,..., L ) { 
auto L, ..., L 
S;... S 
return (E) 

} 

Functions in -1 math library 
s(x) sine 

c(x) cosine 

e(x) exponential 

l(x) log 

a(x) arctangent 

j(n,x) Bessel function 
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All function arguments are passed by value. 

The value of a statement that is an expression is printed unless the main operator is an assignment. Either 
semicolons or new-lines may separate statements. Assignment to scale influences the number of digits to 
be retained on arithmetic operations in the manner of dc( 1). Assignments to ibase or obase set the input 
and output number radix respectively. 

The same letter may be used as an array, a function, and a simple variable simultaneously. All variables are 
global to the program. “Auto” variables are pushed down during function calls. When using arrays as 
function arguments or defining them as automatic variables empty square brackets must follow the array 
name. 

Be is actually a preprocessor for dc( 1), which it invokes automatically, unless the -c (compile only) option 
is present. In this case the dc input is sent to the standard output instead. 

EXAMPLE 

scale = 20 
define e(x){ 

auto a, b, c, i, s 
a = 1 
b = 1 
s = 1 

for(i=l; 1==1; i++){ 
a = a*x 
b = b*i 
c = a/b 

if(c == 0) return(s) 
s = s+c 


defines a function to compute an approximate value of the exponential function and 
for(i=l; i<= 10; i++) e(i) 

prints approximate values of the exponential function of the first ten integers. 

FILES 

/usr/lib/lib.b mathematical library 

/usr/bin/dc desk calculator proper 

SEE ALSO 

dc(l). 

BC-An Arbitrary Precision Desk-Calculator Language by L. L. Cherry and R. Morris. 

BUGS 

No &&, I I yet. 

For statement must have all three E’s. 

Quit is interpreted when read, not when executed. 
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NAME 

bdiff - big diff 
SYNOPSIS 

bdiff filel file2 [n] [-s] 

DESCRIPTION 

Bdiff is used in a manner analogous to diff{ 1) to find which lines must be changed in two files to bring them 
into agreement. Its purpose is to allow processing of files which are too large for diff. Bdiff ignores lines 
common to the beginning of both files, splits the remainder of each file into n -line segments, and invokes 
diff upon corresponding segments. The value of n is 3500 by default. If the optional third argument is 
given, and it is numeric, it is used as the value for n. This is useful in those cases in which 3500-line seg¬ 
ments are too large for diff, causing it to fail. If filel (file2) is -, the standard input is read. The optional -s 
(silent) argument specifies that no diagnostics are to be printed by bdiff (note, however, that this does not 
suppress possible exclamations by diff. If both optional arguments are specified, they must appear in the 
order indicated above. 

The output of bdiff is exactly that of diff, with line numbers adjusted to account for the segmenting of the 
files (that is, to make it look as if the files had been processed whole). Note that because of the segmenting 
of the files, bdiff does not necessarily find a smallest sufficient set of file differences. 

FILES 

/tmp/bd????? 

SEE ALSO 

diff(l). 

DIAGNOSTICS 

Use help{ 1) for explanations. 


Page 1 




BFS(l) 


BFS(l) 


NAME 

bfs - big file scanner 

SYNOPSIS 

bfs [ - ] name 

DESCRIPTION 

Bfs is (almost) like eel( I) except that it is read-only and processes much larger files. Files can be up to 
1024K bytes (the maximum possible size) and 32K lines, with up to 255 characters per line. Bfs is usually 
more efficient than eel for scanning a file, since the file is not copied to a buffer. It is most useful for identi¬ 
fying sections of a large file where csplit( 1) can be used to divide it into more manageable pieces for edit¬ 
ing. 

Normally, the size of the file being scanned is printed, as is the size of any file written with the w command. 
The optional - suppresses printing of sizes. Input is prompted with * if P and a carriage return are typed as 
in eel. Prompting can be turned off again by inputting another P and carriage return. Note that messages 
are given in response to errors if prompting is turned on. 

All address expressions described under ed are supported. In addition, regular expressions may be sur¬ 
rounded with two symbols besides / and ?: > indicates downward search without wrap-around, and < indi¬ 
cates upward search without wrap-around. Since bfs uses a different regular expression-matching routine 
from ed, the regular expressions accepted are slightly wider in scope (see regcmp{ 3X)). There is a slight 
difference in mark names: only the letters a through z may be used, and all 26 marks are remembered. 

The e, g, v, k, n, p, q, w, =, ! and null commands operate as described under ed. Commands such as-, 

+++- , +++=, - 12 , and +4p are accepted. Note that 1,1 Op and 1,10 will both print the first ten lines. The f 
command only prints the name of the file being scanned; there is no remembered file name. The w com¬ 
mand is independent of output diversion, truncation, or crunching (see the xo, xt and xc commands, below). 
The following additional commands are available: 

xf file 

Further commands are taken from the named file. When an end-of-file is reached, an interrupt 
signal is received or an error occurs, reading resumes with the file containing the xf. Xf com¬ 
mands may be nested to a depth of 10. 

xo [file ] 

Further output from the p and null commands is diverted to the named file, which, if necessary, 
is created mode 666. If file is missing, output is diverted to the standard output. Note that 
each diversion causes truncation or creation of the file. 

: label 

This positions a label in a command file. The label is terminated by new-line, and blanks 
between the : and the start of the label are ignored. This command may also be used to insert 
comments into a command file, since labels need not be referenced. 

( .,. )xb /regular expression/label 

A jump (either upward or downward) is made to label if the command succeeds. It fails under 
any of the following conditions: 

1. Either address is not between 1 and $. 

2. The second address is less than the first. 

3. The regular expression doesn't match at least one line in the specified range, 
including the first and last lines. 

On success,. is set to the line matched and a jump is made to label. This command is the only 
one that doesn't issue an error message on bad addresses, so it may be used to test whether 
addresses are bad before other commands are executed. Note that the command 

xb/7 label 
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is an unconditional jump. 

The xb command is allowed only if it is read from someplace other than a terminal. If it is 
read from a pipe only a downward jump is possible. 

xt number 

Output from the p and null commands is truncated to at most number characters. The initial 
number is 255. 

xy [digit] [spaces] [value] 

The variable name is the specified digit following the xv. xv5100 or xv5 100 both assign the 
value 100 to the variable 5. Xv61,100p assigns the value l,100p to the variable 6. To refer¬ 
ence a variable, put a % in front of the variable name. For example, using the above assign¬ 
ments for variables 5 and 6: 

l,%5p 

1,%5 

%6 

will all print the first 100 lines. 
g/%5/p 

would globally search for the characters 100 and print each line containing a match. To escape 
the special meaning of %, a \ must precede it. 

g/".*\%[cds]/p 

could be used to match and list lines containing printf of characters, decimal integers, or 
strings. 

Another feature of the xv command is that the first line of output from a UNIX System com¬ 
mand can be stored into a variable. The only requirement is that the first character of value be 
an !. For example: 

•w junk 
xv5!cat junk 
!rm junk 
!echo "%5" 
xv6!expr %6 + 1 

would put the current line into variable 5, print it, and increment the variable 6 by one. To 
escape the special meaning of ! as the first character of value , precede it with a Y 

xv7\!date 

stores the value Idate into variable 7. 
xbz label 

xbn label 

These two commands will test the last saved return code from the execution of a UNIX System 
command {[command) or nonzero value, respectively, to the specified label. The two exam¬ 
ples below both search for the next five lines containing the string size. 

xv55 

: 1 

/size/ 

xv5!expr %5 - 1 
!if 0%5 != 0 exit 2 
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xbn 1 
xv45 

: 1 

/size/ 

xv4!expr %4 - 1 
!if 0%4 = 0 exit 2 
xbz 1 

xc [switch] 

If switch is 1, output from the p and null commands is crunched; if switch is 0 it isn’t. With¬ 
out an argument, xc reverses switch. Initially switch is set for no crunching. Crunched output 
has strings of tabs and blanks reduced to one blank and blank lines suppressed. 

SEE ALSO 

csplit(l), ed(l), regcmp(3X). 

DIAGNOSTICS 

? for errors in commands, if prompting is turned off. Self-explanatory error messages when prompting is 
on. 
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NAME 

bs - a compiler/interpreter for modest-sized programs 

SYNOPSIS 

bs [ file [ args ] ] 

DESCRIPTION 

Bs is a remote descendant of Basic and Snobol4 with a little C language thrown in. Bs is designed for pro¬ 
gramming tasks where program development time is as important as the resulting speed of execution. For¬ 
malities of data declaration and file/process manipulation are minimized. Line-at-a-time debugging, the 
trace and dump statements, and useful run-time error messages all simplify program testing. Furthermore, 
incomplete programs can be debugged; inner functions can be tested before outer functions have been writ¬ 
ten and vice versa. 

If the command line file argument is provided, the file is used for input before the console is read. By 
default, statements read from the file argument are compiled for later execution. Likewise, statements 
entered from the console are normally executed immediately (see compile and execute below). Unless the 
final operation is assignment, the result of an immediate expression statement is printed. 

Bs programs are made up of input lines. If the last character on a line is a V the line is continued. Bs 
accepts lines of the following form: 

statement 
label statement 

A label is a name (see below) followed by a colon. A label and a variable can have the same name. 

A bs statement is either an expression or a keyword followed by zero or more expressions. Some keywords 
(clear, compile,!, execute, include, ibase, obase, and run ) are always executed as they are compiled. 

Statement Syntax: 

expression 

The expression is executed for its side effects (value, assignment or function call). The details of 
expressions follow the description of statement types below. 

break 

Break exits from the inner-most for/while loop. 

clear 

Clears the symbol table and compiled statements. Clear is executed immediately, 
compile [ expression ] 

Succeeding statements are compiled (overrides the immediate execution default). The optional expres¬ 
sion is evaluated and used as a file name for further input. A clear is associated with this latter case. 
Compile is executed immediately. 

continue 

Continue transfers to the loop-continuation of the current for/while loop, 
dump [ name ] 

The name and current value of every non-local variable is printed. Optionally, only the named variable 
is reported. After an error or interrupt, the number of the last statement and (possibly) the user-function 
trace are displayed. 

exit [ expression ] 

Return to system level. The expression is returned as process status. 

execute 

Change to immediate execution mode (an interrupt has a similar effect). This statement does not cause 
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stored statements to execute (see run below). 

for name = expression expression statement 
for name = expression expression 

next 

for expression , expression , expression statement 
for expression , expression , expression 

next 

The for statement repetitively executes a statement (first form) or a group of statements (second form) 
under control of a named variable. The variable takes on the value of the first expression, then is incre¬ 
mented by one on each loop, not to exceed the value of the second expression. The third and fourth 
forms require three expressions separated by commas. The first of these is the initialization, the second 
is the test (true to continue), and the third is the loop-continuation action (normally an increment). 

fun f( [ a, ... ]) [v, ... ] 

nuf 

Fun defines the function name, arguments, and local variables for a user-written function. Up to ten 
arguments and local variables are allowed. Such names cannot be arrays, nor can they be I/O associ¬ 
ated. Function definitions may not be nested. 

freturn 

A way to signal the failure of a user-written function. See the interrogation operator (?) below. If inter¬ 
rogation is not present, freturn merely returns zero. When interrogation is active, freturn transfers to 
that expression (possibly by-passing intermediate function returns). 

goto name 

Control is passed to the internally stored statement with the matching label. 

ibase N 

lbase sets the input base (radix) to N. The only supported values for N are 8, 10 (the default), and 16. 
Hexadecimal values 10-15 are entered as a-f. A leading digit is required (i.e., fOa must be entered as 
OfOa). Ibase (and obase, below) are executed immediately. 

if expression statement 
if expression 

[ else 

... ] 

fi 

The statement (first form) or group of statements (second form) is executed if the expression evaluates 
to non-zero. The strings 0 and "" (null) evaluate as zero. In the second form, an optional else allows 
for a group of statements to be executed when the first group is not. The only statement permitted on 
the same line with an else is an //; only other//A can be on the same line with a fi. The elision of else 
and if into an el if is supported. Only a single// is required to close an if... elif.. . [ else ... ] sequence. 

include expression 

The expression must evaluate to a file name. The file must contain bs source statements. Such state¬ 
ments become part of the program being compiled. Include statements may not be nested. 

obase N 

Obase sets the output base to N (see ibase above). 

onintr label 
onintr 

The onintr command provides program control of interrupts. In the first form, control will pass to the 
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label given, just as if a goto had been executed at the time onintr was executed. The effect of the state¬ 
ment is cleared after each interrupt. In the second form, an interrupt will cause bs to terminate. 

return [expression] 

The expression is evaluated and the result is passed back as the value of a function call. If no expres¬ 
sion is given, zero is returned. 

run 

The random number generator is reset. Control is passed to the first internal statement. If the run state¬ 
ment is contained in a file, it should be the last statement. 

stop 

Execution of internal statements is stopped. Bs reverts to immediate mode, 
trace [ expression ] 

The trace statement controls function tracing. If the expression is null (or evaluates to zero), tracing is 
turned off. Otherwise, a record of user-function calls/returns will be printed. Each return decrements 
the trace expression value. 

while expression statement 
while expression 

next 

While is similar to for except that only the conditional expression for loop-continuation is given. 

! shell command 

An immediate escape to the Shell. 

# ... 

This statement is ignored. It is used to interject commentary in a program. 

Expression Syntax: 

name 

A name is used to specify a variable. Names are composed of a letter (upper or lower case) optionally 
followed by letters and digits. Only the first six characters of a name are significant. Except for names 
declared in fun statements, all names are global to the program. Names can take on numeric (double 
float) values, string values, or can be associated with input/output (see the built-in function open{) 
below). 

name ( [expression [ , expression] ... ]) 

Functions can be called by a name followed by the arguments in parentheses separated by commas. 
Except for built-in functions (listed below), the name must be defined with a fun statement. Arguments 
to functions are passed by value. 

name [ expression [, expression ] ... ] 

This syntax is used to reference either arrays or tables (see built-in table functions below). For arrays, 
each expression is truncated to an integer and used as a specifier for the name. The resulting array ref¬ 
erence is syntactically identical to a name; a[l,2] is the same as a[l][2]. The truncated expressions are 
restricted to values between 0 and 32767. 

number 

A number is used to represent a constant value. A number is written in Fortran style, and contains dig¬ 
its, an optional decimal point, and possibly a scale factor consisting of an e followed by a possibly 
signed exponent. 

string 

Character strings are delimited by " characters. The \ escape character allows the double quote (V), 
new-line (\n), carriage return (\r), backspace (\b), and tab (At) characters to appear in a string. Other¬ 
wise, \ stands for itself. 
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( expression ) 

Parentheses are used to alter the normal order of evaluation. 

( expression, expression [, expression ...])[ expression ] 

The bracketed expression is used as a subscript to select a comma-separated expression from the paren¬ 
thesized list. List elements are numbered from the left, starting at zero. The expression: 

(False, True )[ a == b ] 

has the value True if the comparison is true. 

? expression 

The interrogation operator tests for the success of the expression rather than its value. At the moment, 
it is useful for testing end-of-file (see examples in the Programming Tips section below), the result of 
the eval built-in function, and for checking the return from user-written functions (see fret urn). An 
interrogation “trap” (end-of-file, etc.) causes an immediate transfer to the most recent interrogation, 
possibly skipping assignment statements or intervening function levels. 

- expression 

The result is the negation of the expression. 

++ name 

Increments the value of the variable (or array reference). The result is the new value. 

— name 

Decrements the value of the variable. The result is the new value. 

! expression 

The logical negation of the expression. Watch out for the shell escape command, 
expression operator expression 

Common functions of two arguments are abbreviated by the two arguments separated by an operator 
denoting the function. Except for the assignment, concatenation, and relational operators, both 
operands are converted to numeric form before the function is applied. 

Binary Operators (in increasing precedence): 


= is the assignment operator. The left operand must be a name or an array element. The result is the 
right operand. Assignment binds right to left, all other operators bind left to right. 


(underscore) is the concatenation operator. 

& I 

& (logical and) has result zero if either of its arguments are zero. It has result one if both of its argu¬ 
ments are non-zero; I (logical or) has result zero if both of its arguments are zero. It has result one if 
either of its arguments is non-zero. Both operators treat a null string as a zero. 

<<=>>= == != 

The relational operators (< less than, <= less than or equal, > greater than, >= greater than or equal, == 
equal to, != not equal to) return one if their arguments are in the specified relation. They return zero 
otherwise. Relational operators at the same level extend as follows: a>b>c is the same as a>b & b>c. 
A string comparison is made if both operands are strings. 

+ - 

Add and subtract. 

* / % 

Multiply, divide, and remainder. 
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Exponentiation. 

Built-in Functions: 

Dealing with arguments 

arg(i) 

is the value of the ;-th actual parameter on the current level of function call. At level zero, arg returns 
the ;-th command-line argument (arg( 0) returns bs). 

narg() 

returns the number of arguments passed. At level zero, the command argument count is returned. 

Mathematical 

abs(x) 

is the absolute value of x. 

atan(x) 

is the arctangent of x. Its value is between -n/2 and Jt/2. 
ceil(x) 

returns the smallest integer not less than x. 
cos(x) 

is the cosine of x (radians). 
exp(x) 

is the exponential function of x. 

floor(x) 

returns the largest integer not greater than x. 
log(x) 

is the natural logarithm of x. 

rand() 

is a uniformly distributed random number between zero and one. 
sin(x) 

is the sine of x (radians). 
sqrt(x) 

is the square root of x. 

String operations 

size(s) 

the size (length in bytes) of ,v is returned. 

format(f, a) 

returns the formatted value of a. F is assumed to be a format specification in the style of printf(3S). 
Only the % ... f, % . . .e, and % ...s types are safe. 

index(x, y) 

returns the number of the first position in x that any of the characters from y matches. No match yields 
zero. 

trans(s, f, t) 

Translates characters of the source s from matching characters in/to a character in the same position in 
t. Source characters that do not appear in / are copied to the result. If the string / is longer than t, 
source characters that match in the excess portion off do not appear in the result. 

substr(s, start, width) 

returns the sub-string of s defined by the starting position and width. 
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match(string, pattern) 
mstring(n) 

The pattern is similar to the regular expression syntax of the ed( 1) command. The characters [, ], ~ 
(inside brackets), * and $ are special. The mstring function returns the «-th (1 <= n <= 10) substring of 
the subject that occurred between pairs of the pattern symbols \( and \) for the most recent call to match. 
To succeed, patterns must match the beginning of the string (as if all patterns began with ''). The func¬ 
tion returns the number of characters matched. For example: 

match("al23abl23", " *\([a-z]\)") == 6 
mstring( 1) == "b" 

File handling 

open(name, file, function) 
close(name) 

The name argument must be a bs variable name (passed as a string). For the open , the file argument 
may be 1 ) a 0 (zero), 1, or 2 representing standard input, output, or error output, respectively, 2 ) a string 
representing a file name, or 3) a string beginning with an ! representing a command to be executed (via 
sh -c ). The function argument must be either r (read), w (write), W (write without new-line), or a 
(append). After a close, the name reverts to being an ordinary variable. The initial associations are: 

open("get", 0, "r") 
openC’put", 1, "w") 
open("puterr", 2, "w") 

Examples are given in the following section. 

access(s, m) 

executes access ( 2). 

ftype(s) 

returns a single character file type indication: f for regular file, p for FIFO (i.e., named pipe), d for 
directory, b for block special, or c for character special. 

Tables 

table(name, size) 

A table in bs is an associatively accessed, single-dimension array. “Subscripts” (called keys) are 
strings (numbers are converted). The name argument must be a bs variable name (passed as a string). 
The size argument sets the minimum number of elements to be allocated. Bs prints an error message 
and stops on table overflow. 

item(name, i) 

key() 

The item function accesses table elements sequentially (in normal use, there is no orderly progression of 
key values). Where the item function accesses values, the key function accesses the “subscript” of the 
previous item call. The name argument should not be quoted. Since exact table sizes are not defined, 
the interrogation operator should be used to detect end-of-table, for example: 

table("t", 100) 

# If word contains "party", the following expression adds one 

# to the count of that word: 

++t[word] 

# To print out the the key/value pairs: 

for i = 0, ?(s = item(t, i)), ++i if key() put = key()_":"_s 

iskey(name, word) 

The iskey function tests whether the key word exists in the table name and returns one for true, zero for 
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false. 


Odds and ends 


eval(s) 

The string argument is evaluated as a bs expression. The function is handy for converting numeric 
strings to numeric internal form. Eval can also be used as a crude form of indirection, as in: 

name = "xyz" 
eval("++"_ name) 

which increments the variable xyz . In addition, eval preceded by the interrogation operator permits the 
user to control bs error conditions. For example: 

?eval("open(\"X\", Y'XXXY', Y'r\")") 

returns the value zero if there is no file named “XXX” (instead of halting the user’s program). The fol¬ 
lowing executes a goto to the label L (if it exists): 

label="L" 

if !(?eval("goto label)) puterr = "no label" 

plot(request, args) 

The plot function produces output on devices recognized by tplot{ 1G). The requests are as follows: 


Call Function 

plot(0, term) 

causes further plot output to be piped into 1plot{ 1G) with an 
argument of -T term. 

plot(4) 

“erases” the plotter. 

plot(2, string) 

labels the current point with string. 

plot(3, xl, yl, x2, y2) 

draws the line between (xl ,yl) and (x2,y2). 

plot(4, x, y, r) 

draws a circle with center ( x,y ) and radius r. 

plot(5, xl, yl, x2, y2, x3, y3) 

draws an arc (counterclockwise) with center ( xl,yl) and end¬ 
points (x2,y2) and (x3,y3). 

plot(6) 

is not implemented. 

plot(7, x, y) 

makes the current point (x,y). 

plot(8, x, y) 

draws a line from the current point to (x,y). 

plot(9, x, y) 

draws a point at ( x,y). 

plot(10, string) 

sets the line mode to string. 

plot(ll, xl, yl, x2, y2) 

makes ( xl,yl ) the lower left corner of the plotting area and 
(x2,y2) the upper right corner of the plotting area. 

plot(12, xl, yl, x2, y2) 

causes subsequent x (y) coordinates to be multiplied by xl (yl) 
and then added to x2 (y2) before they are plotted. The initial 
scaling is plot(12,1.0,1.0, 0.0, 0.0). 


Some requests do not apply to all plotters. All requests except zero and twelve are implemented by pip¬ 
ing characters to tplot( 1G). See plot (4) for more details. 

last() 

in immediate mode, last returns the most recently computed value. 

PROGRAMMING TIPS 

Using bs as a calculator: 

$ bs 

# Distance (inches) light travels in a nanosecond. 
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186000 * 5280 * 12/le9 

11.78496 


# Compound interest (6% for 5 years on $1,000). 
int = .06 / 4 

bal = 1000 

for i = 1 5*4 bal = bal + bal*int 
bal - 1000 

346.855007 

exit 

The outline of a typical bs program: 

# initialize things: 
varl = 1 

openC'read", "infile", "r") 

# compute: 
while ?(str = read) 

next 

# clean up: 
close("read") 

# last statement executed (exit or stop): 
exit 

# last input line: 
run 

Input/Output examples: 

# Copy "oldfile" to "newfile". 
openC'read", "oldfile", "r") 
openC'write", "newfile", "w") 

while ?(write = read) 

# close "read" and "write": 
close("read") 
close("write") 

# Pipe between commands. 
open("ls", "!ls *", "r") 
openC'pr", "!pr -2 -h 'List'", "w") 
while ?(pr = Is) ... 

# be sure to close (wait for) these: 
close("ls") 

close("pr") 

SEE ALSO 

ed(l), sh(l), tplot(lG), access(2), printf(3S), stdio(3S), plot(4). 

See Section 3 of this volume for further description of the mathematical functions (pow on exp{ 3M) is used 
for exponentiation); bs uses the Standard Input/Output package. 
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NAME 

cal - print calendar 

SYNOPSIS 

cal [ month ] year 

DESCRIPTION 

Cal prints a calendar for the specified year. If a month is also specified, a calendar just for that month is 
printed. Year can be between 1 and 9999. The month is a number between 1 and 12. The calendar pro¬ 
duced is that for England and her colonies. 

Try September 1752. 

BUGS 

The year is always considered to start in January even though this is historically naive. 

Beware that “cal 78” refers to the early Christian era, not the 20th century. 
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NAME 

calendar - reminder service 

SYNOPSIS 

calendar [ - ] 

DESCRIPTION 

Calendar consults the file calendar in the current directory and prints out lines that contain today’s or 
tomorrow’s date anywhere in the line. Most reasonable month-day dates such as “Dec. 7,” “december 7,” 
“12/7,” etc., are recognized, but not “7 December’ or “7/12”. On weekends “tomorrow” extends 
through Monday. 

When an argument is present, calendar does its job for every user who has a file calendar in their login 
directory and sends them any positive results by mail(l). Normally this is done daily by facilities in the 
UNIX operating system. 

FILES 

calendar 

/usr/lib/calprog to figure out today’s and tomorrow’s dates 

/etc/passwd 

/tmp/cal* 

SEE ALSO 

mail(l). 

BUGS 

Your calendar must be public information for you to get reminder service. 

Calendar’s extended idea of “tomorrow” does not account for holidays. 
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NAME 

cat - concatenate and print files 
SYNOPSIS 

cat [ -u ] [ -s ] file ... 

DESCRIPTION 

Cat reads each file in sequence and writes it on the standard output. Thus: 
cat file 

prints the file, and: 

cat filel file2 >file3 

concatenates the first two files and places the result on the third. 

If no input file is given, or if the argument - is encountered, cat reads from the standard input file. Output 
is buffered unless the -u option is specified. The -s option makes cat silent about non-existent files. No 
input file may be the same as the output file unless it is a special file. 

WARNING 

Command formats such as 
cat filel file2 >filel 

will cause the original data in filel to be lost, therefore, take care when using shell special characters. 

SEE ALSO 

cp(l), pr( 1). 
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NAME 

cb - C program beautifier 
SYNOPSIS 

cb [ -s ] [ -j ] [ -1 leng ] [ file ... ] 

DESCRIPTION 

Cb reads C programs either from its arguments or from the standard input and writes them on the standard 
output with spacing and indentation that displays the structure of the code. Under default options, cb pre¬ 
serves all user new-lines. Under the -s flag cb canonicalizes the code to the style of Kernighan and Ritchie 
in The C Programming Language . The -j flag causes split lines to be put back together. The -1 flag causes 
cb to split lines that are longer than leng. 

SEE ALSO 

cc(l). 

The C Programming Language by B. W. Kernighan and D. M. Ritchie. 

BUGS 

Punctuation that is hidden in preprocessor statements will cause indentation errors. 
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NAME 

cc, pcc - C compiler 

SYNOPSIS 

cc [ option ] ... file ... 
pcc [ option ] ... file ... 

DESCRIPTION 

Cc is the UNIX System C compiler. Pcc is the portable version for a PDP-11 machine. They accept several 
types of arguments: 

Arguments whose names end with .c are taken to be C source programs; they are compiled, and each object 
program is left on the file whose name is that of the source with .o substituted for .c. The .o file is normally 
deleted, however, if a single C program is compiled and loaded all at one go. 

In the same way, arguments whose names end with .s are taken to be assembly source programs and are 
assembled, producing a .o file. 

The following options are interpreted by cc and pcc. See ld( 1) for link editor options and cpp (1) for more 
preprocessor options. 

-c Suppress the link edit phase of the compilation, and force an object file to be produced even if 

only one program is compiled. 

-p Arrange for the compiler to produce code which counts the number of times each routine is 

called; also, if link editing takes place, replace the standard startoff routine by one which auto¬ 
matically calls monitor{ 3C) at the start and arranges to write out a mon.out file at normal termi¬ 
nation of execution of the object program. An execution profile can then be generated by use of 
prof(l). 

-f Link the object program with the floating-point interpreter for systems without hardware 

floating-point. 

-g Cause the compiler to generate additional information needed for the use of sdb (1). (Not for 

PDP-11.) 

-O Invoke an object-code optimizer. 

-S Compile the named C programs, and leave the assembler-language output on corresponding files 

suffixed .s. 

-E Run only cpp (1) on the named C programs, and send the result to the standard output. 

-P Run only cpp ( 1 ) on the named C programs, and leave the result on corresponding files suffixed i. 

-B string Construct pathnames for substitute compiler, assembler and link editor passes by concatenating 
string with the suffixes cpp, cO (or ccom or comp, see under FILES below), cl, c2, as and Id. If 
string is empty it is taken to be /lib/o. 

-t|p012al] 

Find only the designated compiler, assembler and link editor passes in the files whose names are 
constructed by a -B option. In the absence of a -B option, the string is taken to be /Iib/n. -t "" 
is equivalent to -tp012. 

-SVc,argl [,arg2...] 

Hand off the arguments] argi to pass c where c is one of [p012al] indicating preprocessor, com¬ 
piler first pass, compiler second pass, optimizer, assembler, or link editor, respectively. 

-d This option is no longer allowed because of a conflict of meaning. The -W option must be used 

to specify precisely its destination. To indicate the -An option for the VAX assembler, use 
-Wa,-dn. To indicate the -d option for the link editor, use -Wl,-d. 

Other arguments are taken to be either link editor option arguments, C preprocessor option arguments, or 
C-compatible object programs, typically produced by an earlier cc or pcc run, or perhaps libraries of C- 
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compatible routines. These programs, together with the results of any compilations specified, are linked (in 
the order given) to produce an executable program with the name a.out. 

FILES 


file.c 

input file 

file.o 

object file 

a.out 

linked output 

/tmp/ctm* 

temporary 

/lib/cpp 

C preprocessor cpp (1) 

/lib/c[01] 

PDP-11 compiler, cc 

/usr/lib/comp 

compiler, pcc 

/lib/ccom 

VAX compiler, cc 

/lib/c2 

optional optimizer 

/lib/oc* 

backup compiler, occ 

/lib/nc* 

test compiler, ncc 

/bin/as 

assembler, os(l) 

/bin/ld 

link editor, ld( 1) 

/lib/crtO.o 

runtime startoff 

/lib/mcrtO.o 

startoff for profiling 

/lib/fcrtO.o 

startoff for floating-point interpretation (PDP-11 only) 

/lib/fmcrtO.o 

startoff for floating-point interpretation and profiling (PDP-11 only) 

/lib/libc.a 

standard library, see (3) 


SEE ALSO 

The C Programming Language by B. W. Kernighan and D. M. Ritchie. 

Programming in C-A Tutorial by B. W. Kernighan. 

C Reference Manual by D. M. Ritchie. 

adb(l), cpp(l), as(l), ld(l), prof(l), sdb(l), monitor(3C). 

DIAGNOSTICS 

The diagnostics produced by C itself are intended to be self-explanatory. Occasional messages may be pro¬ 
duced by the assembler or the link editor. Of these, the most mystifying are from the PDP-11 assembler, in 
particular m, which means a multiply-defined external symbol (function or data). 
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NAME 

cd - change working directory 

SYNOPSIS 

cd [ directory ] 

DESCRIPTION 

If directory is not specified, the value of shell parameter $HOME is used as the new working directory. If 
directory specifies a complete path starting with /, directory becomes the new working directory. If 
neither case applies, cd tries to find the designated directory relative to one of the paths specified by the 
$CDPATH shell variable. $CDPATH has the same syntax as, and similar semantics to, the $PATH shell 
variable. Cd must have execute (search) permission in directory. 

Because a new process is created to execute each command, cd would be ineffective if it were written as a 
normal command; therefore, it is recognized and internal to the shell. 

SEE ALSO 

pwd(l), sh(l), chdir(2). 
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NAME 

cdc - change the delta commentary of an SCCS delta 
SYNOPSIS 

cdc -rSID [-m[mrlist]] [-y[comment]] files 

DESCRIPTION 

Cdc changes the delta commentary, for the SID specified by the -r keyletter, of each named SCCS file. 

Delta commentary is defined to be the Modification Request (MR) and comment information normally 
specified via the delta( 1) command (-m and -y keyletters). 

If a directory is named, cdc behaves as though each file in the directory were specified as a named file, 
except that non-SCCS files (last component of the path name does not begin with s.) and unreadable files 
are silently ignored. If a name of - is given, the standard input is read (see WARNINGS)', each line of the 
standard input is taken to be the name of an SCCS file to be processed. 

Arguments to cdc, which may appear in any order, consist of keyletter arguments, and file names. 

All the described keyletter arguments apply independently to each named file: 

-r SID Used to specify the S CCS /Dentification (SID) string of a delta for which the delta 

commentary is to be changed. 

-m [mrlist] If the SCCS file has the v flag set (see admin ( 1)) then a list of MR numbers to be 

added and/or deleted in the delta commentary of the SID specified by the -r keylet¬ 
ter may be supplied. A null MR list has no effect. 

MR entries are added to the list of MRs in the same manner as that of delta) 1). In 
order to delete an MR, precede the MR number with the character ! (see EXAM¬ 
PLES). If the MR to be deleted is currently in the list of MRs, it is removed and 
changed into a “comment” line. A list of all deleted MRs is placed in the com¬ 
ment section of the delta commentary and preceded by a comment line stating that 
they were deleted. 

If -m is not used and the standard input is a terminal, the prompt MRs? is issued 
on the standard output before the standard input is read; if the standard input is not 
a terminal, no prompt is issued. The MRs? prompt always precedes the com¬ 
ments? prompt (see -y keyletter). 

MRs in a list are separated by blanks and/or tab characters. An unescaped new- 
line character terminates the MR list. 

Note that if the v flag has a value (see admin) 1)), it is taken to be the name of a 
program (or shell procedure) which validates the correctness of the MR numbers. 
If a non-zero exit status is returned from the MR number validation program, cdc 
terminates and the delta commentary remains unchanged. 

-y [comment] Arbitrary text used to replace the comment (s) already existing for the delta 
specified by the -r keyletter. The previous comments are kept and preceded by a 
comment line stating that they were changed. A null comment has no effect. 

If -y is not specified and the standard input is a terminal, the prompt comments? 
is issued on the standard output before the standard input is read; if the standard 
input is not a terminal, no prompt is issued. An unescaped new-line character ter¬ 
minates the comment text. 

The exact permissions necessary to modify the SCCS file are documented in the Source Code Control 
System User’s Guide. Simply stated, they are either (1) if you made the delta, you can change its 
delta commentary; or (2) if you own the file and directory you can modify the delta commentary. 

EXAMPLES 

cdc -rl.6 -m"bl78-12345 !bl77-54321 bl79-00001" -ytrouble s.file 
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adds bl78-12345 and bl79-00001 to the MR list, removes bl77-54321 from the MR list, and adds the com¬ 
ment trouble to delta 1.6 of s.file. 

cdc -rl.6 s.file 

MRs? !bl77-54321 bl78-12345 bl79-00001 
comments? trouble 

does the same thing. 

WARNINGS 

If SCCS file names are supplied to the cdc command via the standard input (- on the command line), then 
the -m and -y keyletters must also be used. 

FILES 

x-file (see delta (1)) 

z-file (see delta (1)) 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l), sccsfile(4). 

Source Code Control System User’s Guide in the UNIX System User’s Guide. 

DIAGNOSTICS 

Use help( 1) for explanations. 
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NAME 

cflow - generate C flow graph 
SYNOPSIS 

cflow [-r] [— ix] [-i_] [-dnum] files 
DESCRIPTION 

Cflow analyzes a collection of C, YACC, LEX, assembler, and object files and attempts to build a graph 
charting the external references. Files suffixed in .y, 1, .c, and ,i are YACC’d, LEX’d, and C-preprocessed 
(bypassed for i files) as appropriate and then run through the first pass of lint( 1). (The -I, -D, and -U 
options of the C-preprocessor are also understood.) Files suffixed with ,s are assembled and information is 
extracted (as in .0 files) from the symbol table. The output of all this non-trivial processing is collected and 
turned into a graph of external references which is displayed upon the standard output. 

Each line of output begins with a reference (i.e., line) number, followed by a suitable number of tabs indi¬ 
cating the level. Then the name of the global (normally only a function not defined as an external or begin¬ 
ning with an underscore; see below for the -i inclusion option) a colon and its definition. For information 
extracted from C source, the definition consists of an abstract type declaration (e.g., char *), and, delimited 
by angle brackets, the name of the source file and the line number where the definition was found. 
Definitions extracted from object files indicate the file name and location counter under which the symbol 
appeared (e.g., text). Leading underscores in C-style external names are deleted. 

Once a definition of a name has been printed, subsequent references to that name contain only the reference 
number of the line where the definition may be found. For undefined references, only <> is printed. 

As an example, given the following in file.c: 


int 

i; 

main() 

/ 


1 

f(); 


g(); 


f(); 


} 

f() 

{ 

i = h(); 

} 

the command 

cflow file.c 

produces the the output 

1 main: int(), <file.c 4> 

2 f: int(), <file.c 11> 

3 h: <> 

4 i: int, <file.c 1> 

5 g: <> 

When the nesting level becomes too deep, the -e option of pr( 1) can be used to compress the tab expansion 
to something less than every eight spaces. 
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The following options are interpreted by cflow : 

-r Reverse the “caller:callee” relationship producing an inverted listing showing the callers of each 
function. The listing is also sorted in lexicographical order by callee. 

-ix Include external and static data symbols. The default is to include only functions in the flow graph. 

-i Include names that begin with an underscore. The default is to exclude these functions (and data if 

-ix is used). 

-dnum The mini decimal integer indicates the depth at which the flow graph is cut off. By default this is a 
very large number. Attempts to set the cutoff depth to a nonpositive integer will be met with con¬ 
tempt. 

DIAGNOSTICS 

Complains about bad options. Complains about multiple definitions and only believes the first. Other mes¬ 
sages may come from the various programs used (e.g., the C-preprocessor). 

SEE ALSO 

as(l), cc(l), lex(l), lint(l), nm(l), pr(l), yacc(l). 

BUGS 

Files produced by lex{ 1) and yucc (1) cause the reordering of line number declarations which can confuse 

cflow. To get proper results, feed cflow the yucc or lex input. 
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NAME 

chmod - change mode 

SYNOPSIS 

chmod mode files 

DESCRIPTION 

The permissions of the named files are changed according to mode , which may be absolute or symbolic. 
An absolute mode is an octal number constructed from the OR of the following modes: 

4000 set user ID on execution 
2000 set group ID on execution 
1000 sticky bit, see chmod( 2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 

A symbolic mode has the form: 

[ who ] op permission [ op permission ] 

The who part is a combination of the letters u (for user’s permissions), g (group) and o (other). The letter a 
stands for ugo, the default if who is omitted. 

Op can be + to add permission to the file’s mode, - to take away permission, or = to assign permission 
absolutely (all other bits will be reset). 

Permission is any combination of the letters r (read), w (write), x (execute), s (set owner or group ID) and t 
(save text, or sticky); u, g, or o indicate that permission is to be taken from the current mode. Omitting 
permission is only useful with = to take away all permissions. 

Multiple symbolic modes separated by commas may be given. Operations are performed in the order 
specified. The letter s is only useful with u or g and t only works with u. 

Only the owner of a file (or the super-user) may change its mode. 

EXAMPLES 

The first example denies write permission to others, the second makes a file executable: 
chmod o-w file 
chmod +X file 

SEE ALSO 

ls( 1), chmod(2). 
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NAME 

chown, chgrp - change owner or group 

SYNOPSIS 

chown owner file ... 

chgrp group file ... 

DESCRIPTION 

Chown changes the owner of the files to owner. The owner may be either a decimal user ID or a login 
name found in the password file. 

Chgrp changes the group ID of the files to group. The group may be either a decimal group ID or a group 
name found in the group file. 

FILES 

/etc/passwd 

/etc/group 

SEE ALSO 

chown(2), group(4), passwd(4). 
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NAME 

cmp - compare two files 
SYNOPSIS 

cmp [ -1 ] [ -s ] filel Me2 
DESCRIPTION 

The two files are compared. (Iffilel is the standard input is used.) Under default options, cmp makes no 
comment if the files are the same; if they differ, it announces the byte and line number at which the differ¬ 
ence occurred. If one file is an initial subsequence of the other, that fact is noted. 

Options: 

-1 Print the byte number (decimal) and the differing bytes (octal) for each difference. 

-s Print nothing for differing files; return codes only. 

SEE ALSO 

comm(l), diff(l). 

DIAGNOSTICS 

Exit code 0 is returned for identical files, 1 for different files, and 2 for an inaccessible or missing argument. 
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NAME 

col - filter reverse line-feeds 

SYNOPSIS 

col [ -bfpx ] 

DESCRIPTION 

Col reads from the standard input and writes onto the standard output. It performs the line overlays implied 
by reverse line feeds (ASCII code ESC-7), and by forward and reverse half-line-feeds (ESC-9 and ESC-8). 
Col is particularly useful for filtering multicolumn output made with the rt command of nrojf and output 
resulting from use of the tbl (I) preprocessor. 

If the -b option is given, col assumes that the output device in use is not capable of backspacing. In this 
case, if two or more characters are to appear in the same place, only the last one read will be output. 

Although col accepts half-line motions in its input, it normally does not emit them on output. Instead, text 
that would appear between lines is moved to the next lower full-line boundary. This treatment can be sup¬ 
pressed by the -f (fine) option; in this case, the output from col may contain forward half-line-feeds (ESC- 
9), but will still never contain either kind of reverse line motion. 

Unless the -x option is given, col will convert white space to tabs on output wherever possible to shorten 
printing time. 

The ASCII control characters SO (\017) and SI (\016) are assumed by col to start and end text in an alternate 
character set. The character set to which each input character belongs is remembered, and on output SI and 
SO characters are generated as appropriate to ensure that each character is printed in the correct character 
set. 

On input, the only control characters accepted are space, backspace, tab, return, new-line, SI, SO, VT 
(\013), and ESC followed by 7, 8, or 9. The VT character is an alternate form of full reverse line-feed, 
included for compatibility with some earlier programs of this type. All other non-printing characters are 
ignored. 

Normally, col will ignore any unknown to it escape sequences found in its input; the -p option may be used 
to cause col to output these sequences as regular characters, subject to overprinting from reverse line 
motions. The use of this option is highly discouraged unless the user is fully aware of the textual position 
of the escape sequences. 

SEE ALSO 

nroffd), tbl(l). 

NOTES 

The input format accepted by col matches the output produced by nroff with either the -T37 or -Tip 
options. Use -T37 (and the -f option of col) if the ultimate disposition of the output of col will be a device 
that can interpret half-line motions, and -Tip otherwise. 

BUGS 

Cannot back up more than 128 lines. 

Allows at most 800 characters, including backspaces, on a line. 

Local vertical motions that would result in backing up over the first line of the document are ignored. As a 
result, the first line must not have any superscripts. 
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NAME 

comb - combine SCCS deltas 

SYNOPSIS 

comb [-o] [—s] [—psid] [—clist] files 
DESCRIPTION 

Comb generates a shell procedure (see sh( 1)) which, when run, will reconstruct the given SCCS files. The 
reconstructed files will, hopefully, be smaller than the original files. The arguments may be specified in any 
order, but all keyletter arguments apply to all named SCCS files. If a directory is named, comb behaves as 
though each file in the directory were specified as a named file, except that non-SCCS files (last component 
of the path name does not begin with s.) and unreadable files are silently ignored. If a name of - is given, 
the standard input is read; each line of the standard input is taken to be the name of an SCCS file to be pro¬ 
cessed; non-SCCS files and unreadable files are silently ignored. 

The generated shell procedure is written on the standard output. 

The keyletter arguments are as follows. Each is explained as though only one named file is to be processed, 
but the effects of any keyletter argument apply independently to each named file. 

-p SID The .S'CCS /Dentification string (SID) of the oldest delta to be preserved. All older deltas are dis¬ 

carded in the reconstructed file. 

-c list A list (see get( 1) for the syntax of a list) of deltas to be preserved. All other deltas are discarded. 

-o For each get -e generated, this argument causes the reconstructed file to be accessed at the release 

of the delta to be created, otherwise the reconstructed file would be accessed at the most recent 
ancestor. Use of the -o keyletter may decrease the size of the reconstructed SCCS file. It may 
also alter the shape of the delta tree of the original file. 

-s This argument causes comb to generate a shell procedure which, when run, will produce a report 

giving, for each file: the file name, size (in blocks) after combining, original size (also in blocks), 
and percentage change computed by: 

100 * (original - combined) / original 

It is recommended that before any SCCS files are actually combined, one should use this option 
to determine exactly how much space is saved by the combining process. 

If no keyletter arguments are specified, comb will preserve only leaf deltas and the minimal number of 
ancestors needed to preserve the tree. 

FILES 

s.COMB The name of the reconstructed SCCS file, 

comb????? Temporary. 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l), sccsfile(4). 

Source Code Control System User’s Guide in the UNIX System User’s Guide. 

DIAGNOSTICS 

Use help( 1) for explanations. 

BUGS 

Comb may rearrange the shape of the tree of deltas. It may not save any space; in fact, it is possible for the 
reconstructed file to actually be larger than the original. 
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NAME 

comm - select or reject lines common to two sorted files 
SYNOPSIS 

comm [ - [ 123 ] ] filel file2 
DESCRIPTION 

Comm reads filel and file2, which should be ordered in ASCII collating sequence (see sort( 1)), and pro¬ 
duces a three-column output: lines only in filel; lines only in file2; and lines in both files. The file name - 
means the standard input. 

Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm -12 prints only the lines com¬ 
mon to the two files; comm -23 prints only lines in the first file but not in the second; comm -123 is a no- 
op. 

SEE ALSO 

cmp(l), difffl), sort(l), uniq(l). 
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NAME 

convert - convert object and archive files to common formats 

SYNOPSIS 

convert infile outfile 

DESCRIPTION 

Convert transforms input infile to output outfile. Infile must be different from outfile. Infile may be any one 
of the following: 

1) a pre-UNIX System 5.0 VAX object file or link edited (a.out) module 

2) a pre-UNIX System 5.0 VAX archive of object files or link edited (a.out) modules 

3) a pre-UNIX System 5.0 3B20S archive of object files or link edited (a.out) modules. 
Convert will transform in file to one of the following: 

1) an equivalent UNIX System 5.0 VAX object file or link edited (a.out) module 

2) an equivalent UNIX System 5.0 portable archive of equivalent object files or link edited 
(a.out) modules 

3) an equivalent UNIX System 5.0 portable archive of unaltered 3B20S object files or link 
edited (a.out) modules. 

All other types of input to the convert( 1) command will be passed unmodified from the input file to the out¬ 
put file (along with appropriate warning messages). When transforming archive files, the convert! 1) com¬ 
mand will inform the user that the archive symbol table has been deleted. The archive symbol table may be 
restored by executing the ar{ 1) command with the s option. 

The convert command may be used in conjunction with the arcv( I) command to transform archives gener¬ 
ated on a PDP-11 to the UNIX System 5.0 archive format for usage on a 3B20S or VAX processor. 

FILES 

/tmp/conv* 

SEE ALSO 

ar(l), arcv(l), a.out(4), ar(4). 
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NAME 

cp. In, mv - copy, link or move files 
SYNOPSIS 

cp file 1 [ file2 ...] target 
In filel [ file2 ...] target 
mv filel [ file2 ...] target 

DESCRIPTION 

Filel is copied (linked, moved) to target. Under no circumstance can filel and target be the same (take 
care when using sh( 1) metacharacters). If target is a directory, then one or more files are copied (linked, 
moved) to that directory. 

If mv determines that the mode of target forbids writing, it will print the mode (see chmod{ 2)) and read the 
standard input for one line (if the standard input is a terminal); if the line begins with y, the move takes 
place; if not, mv exits. 

Only mv will allow filel to be a directory, in which case the directory rename will occur only if the two 
directories have the same parent. 

SEE ALSO 

cpio(l), rm(l), chmod(2). 

BUGS 

If filel and target lie on different file systems, mv must copy the file and delete the original. In this case 
the owner name becomes that of the copying process and any linking relationship with other files is lost. 

Ln will not link across file systems. 
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NAME 

cpio - copy file archives in and out 

SYNOPSIS 

cpio -o [ acBv ] 

cpio -i [ BcdmrtuvfsSb6 ] [ patterns ] 
cpio -p [ adlmruv ] directory 
DESCRIPTION 

Cpio -o (copy out) reads the standard input to obtain a list of path names and copies those files onto the 
standard output together with path name and status information. 

Cpio -i (copy in) extracts files from the standard input which is assumed to be the product of a previous 
cpio -o. Only files with names that match patterns are selected. Patterns are given in the name-generating 
notation of sh( 1). In patterns, meta-characters ?, *, and [...] match the slash / character. Multiple 
patterns may be specified and if no patterns are specified, the default for patterns is * (i.e., select all files). 
The extracted files are conditionally created and copied into the current directory tree based upon the 
options described below. 

Cpio -p (pass) reads the standard input to obtain a list of path names of files that are conditionally created 
and copied into the destination directory tree based upon the options described below. 

The meanings of the available options are: 

a Reset access times of input files after they have been copied. 

B Input/output is to be blocked 5,120 bytes to the record (does not apply to the pass option; mean¬ 
ingful only with data directed to or from /dev/rmt?). 
d Directories are to be created as needed. 

c Write header information in ASCII character form for portability, 

r Interactively rename files. If the user types a null line, the file is skipped, 

t Print a table of contents of the input. No files are created. 

u Copy unconditionally (normally, an older file will not replace a newer file with the same name), 

v Verbose: causes a list of file names to be printed. When used with the t option, the table of con¬ 

tents looks like the output of an Is -1 command (see ls( 1)). 

1 Whenever possible, link files rather than copying them. Usable only with the -p option, 

m Retain previous file modification time. This option is ineffective on directories that are being 
copied. 

f Copy in all files except those in patterns. 

s Swap bytes. Use only with the -i option. 

5 Swap halfwords. Use only with the -i option. 

b Swap both bytes and halfwords. Use only with the -i option. 

6 Process an old (i.e., UNIX System Sixth Edition format) file. Only useful with -i (copy in). 
EXAMPLES 

The first example below copies the contents of a directory into an archive; the second duplicates a directory 
hierarchy: 

Is I cpio -o >/dev/mt0 
cd olddir 

find . -depth -print I cpio -pdl newdir 

The trivial case “find . -depth-print I cpio -oB >/dev/rmt0” can be handled more efficiently by: 
find . -cpio /dev/rmtO 

SEE ALSO 

ar(l), find(l), cpio(4). 
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BUGS 

Path names are restricted to 128 characters. If there are too many unique linked files, the program runs out 
of memory to keep track of them and, thereafter, linking information is lost. Only the super-user can copy 
special files. The -B option does not work with certain magnetic tape drives (see un32(l) in the UNIX 
System Administrator’s Manual). 


Page 2 



CPP(l) 


CPP(l) 


NAME 

cpp - the C language preprocessor 
SYNOPSIS 

/lib/cpp [ option ... ] [ ifile [ ofile ] ] 

DESCRIPTION 

Cpp is the C language preprocessor which is invoked as the first pass of any C compilation using the cc(l) 
command. Thus the output of cpp is designed to be in a form acceptable as input to the next pass of the C 
compiler. As the C language evolves, cpp and the rest of the C compilation package will be modified to 
follow these changes. Therefore, the use of cpp other than in this framework is not suggested. The pre¬ 
ferred way to invoke cpp is through the cc(l) command since the functionality of cpp may someday be 
moved elsewhere. See m4{ 1) for a general macro processor. 

Cpp optionally accepts two file names as arguments. Ifile and ofile are respectively the input and output for 
the preprocessor. They default to standard input and standard output if not supplied. 

The following options to cpp are recognized: 

-P Preprocess the input without producing the line control information used by the next pass of the C 
compiler. 

-C By default, cpp strips C-style comments. If the -C option is specified, all comments (except those 
found on cpp directive lines) are passed along. 

-U name 

Remove any initial definition of name, where name is a reserved symbol that is predefined by the 
particular preprocessor. The current list of these possibly reserved symbols includes: 
operating system: ibm, geos, os, tss, unix 

hardware: interdata, pdpl 1, u370, u3b, vax 

UNIX System variant: RES, RT 

-D name 
-Dname=def 

Define name as if by a #define directive. If no =def is given, name is defined as 1. 

-I dir Change the algorithm for searching for #include files whose names do not begin with / to look in 

dir before looking in the directories on the standard list. Thus, #include files whose names are 
enclosed in " " will be searched for first in the directory of the ifile argument, then in directories 
named in -I options, and last in directories on a standard list. For #include files whose names are 
enclosed in <>, the directory of the ifile argument is not searched. 

Two special names are understood by cpp. The name_LINE_is defined as the current line number (as a 

decimal integer) as known by cpp , and_FILE_is defined as the current file name (as a C string) as 

known by cpp. They can be used anywhere (including in macros) just as any other defined name. 

All cpp directives start with lines begun by #. The directives are: 

#define name token-string 

Replace subsequent instances of name with token-string. 

#define name( arg,arg ) token-string 

Notice that there can be no space between name and the (. Replace subsequent instances of name 
followed by a (, a list of comma separated tokens, and a ) by token-string where each occurrence 
of an arg in the token-string is replaced by the corresponding token in the comma separated list. 

#undef name 

Cause the definition of name (if any) to be forgotten from now on. 

#include "filename" 

#include <filename> 

Include at this point the contents of filename (which will then be run through cpp). When the 
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<filename> notation is used, filename is only searched for in the standard places. See the -I option 
above for more detail. 

#line integer-constant "filename" 

Causes cpp to generate line control information for the next pass of the C compiler. Integer- 
constant is the line number of the next line and filename is the file where it comes from. If 
"filename" is not given, the current file name is unchanged. 

#endif 

Ends a section of lines begun by a test directive (#if, #ifdef, or #ifndef). Each test directive must 
have a matching #endif. 

#ifdef name 

The lines following will appear in the output if and only if name has been the subject of a previous 
#define without being the subject of an intervening #undef. 

#ifndef name 

The lines following will not appear in the output if and only if name has been the subject of a pre¬ 
vious #define without being the subject of an intervening #undef. 

#if constant-expression 

Lines following will appear in the output if and only if the constant-expression evaluates to non¬ 
zero. All binary non-assignment C operators, the ?: operator, the unary —, !, and “ operators are all 
legal in constant-expression. The precedence of the operators is the same as defined by the C lan¬ 
guage. There is also a unary operator defined, which can be used in constant-expression in these 
two forms: defined ( name ) or defined name. This allows the utility of #ifdef and #ifndef in a 
#if directive. Only these operators, integer constants, and names which are known by cpp should 
be used in constant-expression. In particular, the sizeof operator is not available. 

#else Reverses the notion of the test directive which matches this directive. So if lines previous to this 
directive are ignored, the following lines will appear in the output. And vice versa. 

The test directives and the possible #else directives can be nested. 

FILES 

/usr/include standard directory for #include files 

SEE ALSO 

cc(l), m4(l). 

DIAGNOSTICS 

The error messages produced by cpp are intended to be self-explanatory. The line number and filename 
where the error occurred are printed along with the diagnostic. 

NOTES 

When newline characters were found in argument lists for macros to be expanded, previous versions of cpp 
put out the newlines as they were found and expanded. The current version of cpp replaces these newlines 
with blanks to alleviate problems that the previous versions had when this occurred. 
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NAME 

cprs - compress an IS25 object file 

SYNOPSIS 

cprs [—pv] filel file2 

DESCRIPTION 

The cprs command reduces the size of an IS25 object file, filel , by removing duplicate structure and union 
descriptors. The reduced file, file2, is produced as output. 

The options are: 

-p Print statistical messages including: total number of tags, total duplicate tags, and total reduction of 
filel. 

-v Print verbose error messages if error condition occurs. 

SEE ALSO 

strip(l). 
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NAME 

crypt - encode/decode 

SYNOPSIS 

crypt [ password ] 

DESCRIPTION 

Crypt reads from the standard input and writes on the standard output. The password is a key that selects a 
particular transformation. If no password is given, crypt demands a key from the terminal and turns off 
printing while the key is being typed in. Crypt encrypts and decrypts with the same key: 

crypt key <clear >cypher 
crypt key <cypher I pr 

will print the clear. 

Files encrypted by crypt are compatible with those treated by the editor ed in encryption mode. 

The security of encrypted files depends on three factors: the fundamental method must be hard to solve; 
direct search of the key space must be infeasible; “sneak paths” by which keys or clear text can become 
visible must be minimized. 

Crypt implements a one-rotor machine designed along the lines of the German Enigma, but with a 256- 
element rotor. Methods of attack on such machines are known, but not widely; moreover the amount of 
work required is likely to be large. 

The transformation of a key into the internal settings of the machine is deliberately designed to be expen¬ 
sive, i.e. to take a substantial fraction of a second to compute. However, if keys are restricted to (say) three 
lower-case letters, then encrypted files can be read by expending only a substantial fraction of five minutes 
of machine time. 

Since the key is an argument to the crypt command, it is potentially visible to users executing ps( 1) or a 
derivative. To minimize this possibility, crypt takes care to destroy any record of the key immediately 
upon entry. The choice of keys and key security are the most vulnerable aspect of crypt. 

FILES 

/dev/tty for typed key 

SEE ALSO 

ed(l), makekey(l). 

BUGS 

If output is piped to nroff and the encryption key is not given on the command line, crypt can leave termi¬ 
nal modes in a strange state (see iffy(l)). 

If two or more files encrypted with the same key are concatenated and an attempt is made to decrypt the 
result, only the contents of the first of the original files will be decrypted correctly. 
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NAME 

csplit - context split 
SYNOPSIS 

csplit [-s] [-k] [-f prefix] file argl [. . . argn] 

DESCRIPTION 

Csplit reads file and separates it into n+1 sections, defined by the arguments argl. . . argn. By default the 
sections are placed in xxOO . . . xxn (n may not be greater than 99). These sections get the following 
pieces of file: 

00: From the start of file up to (but not including) the line referenced by argl. 

01: From the line referenced by argl up to the line referenced by arg2. 

n+1: From the line referenced by argn to the end of file. 

The options to csplit are: 

-s Csplit normally prints the character counts for each file created. If the -s option is pre¬ 

sent, csplit suppresses the printing of all character counts. 

-k Csplit normally removes created files if an error occurs. If the -k option is present, csplit 

leaves previously created files intact. 

-f prefix If the -f option is used, the created files are named prefix '00 . . . prefixn. The default is 
xxOO . . . xxn. 

The arguments (argl . . . argn) to csplit can be a combination of the following: 

Irexpl A file is to be created for the section from the current line up to (but not including) the line 
containing the regular expression rexp. The current line becomes the line containing 
rexp. This argument may be followed by an optional + or - some number of lines (e.g., 

/Page/-5). 

%rexp% This argument is the same as Irexpl , except that no file is created for the section. 

In no A file is to be created from the current line up to (but not including) Inno. The current 

line becomes Inno. 

{num} Repeat argument. This argument may follow any of the above arguments. If it follows a 
rexp type argument, that argument is applied num more times. If it follows Inno, the file 
will be split every Inno lines ( num times) from that point. 

Enclose all rexp type arguments that contain blanks or other characters meaningful to the Shell in the 
appropriate quotes. Regular expressions may not contain embedded new-lines. Csplit does not affect the 
original file; it is the users responsibility to remove it. 

EXAMPLES 

csplit-f cobol file '/procedure division/' /par5./ /parl6./ 

This example creates four files, cobolOO . . . cobol03. After editing the “split” files, they can be recom¬ 
bined as follows: 

cat cobol0[0-3] > file 

Note that this example overwrites the original file, 
csplit-k file 100 {99} 

This example would split the file at every 100 lines, up to 10,000 lines. The -k option causes the created 
files to be retained if there are less than 10,000 lines; however, an error message would still be printed. 
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csplit-kprog.c '%main(%' T}/+1' {20} 

Assuming that prog.c follows the normal C coding convention of ending routines with a } at the beginning 
of the line, this example will create a file containing each separate C routine (up to 21) in prog.c. 

SEE ALSO 

ed(l), sh(l), regexp(5). 

DIAGNOSTICS 

Self explanatory except for: 

arg - out of range 

which means that the given argument did not reference a line between the current position and the end of 
the file. 


Page 2 



CT(1C) 


CT(1C) 


NAME 

ct - spawn getty to a remote terminal 
SYNOPSIS 

ct [ -h ] [ -v ] [ -wn ] [ -sspeed ] telno ... 

DESCRIPTION 

Ct dials the phone number of a modem that is attached to a terminal, and spawns a getty process to that ter¬ 
minal. Telno is a telephone number, with equal signs for secondary dial tones and minus signs for delays at 
appropriate places. If more than one telephone number is specified, ct will try each in succession until one 
answers; this is useful for specifying alternate dialing paths. 

Ct will try each line listed in the file /usr/lib/uucp/L-devices until it finds an available line with appropriate 
attributes or runs out of entries. If there are no free lines, ct will ask if it should wait for one, and if so, for 
how many minutes it should wait before it gives up. Ct will continue to try to open the dialers at one- 
minute intervals until the specified limit is exceeded. The dialogue may be overridden by specifying the 
-wn option, where n is the maximum number of minutes that ct is to wait for a line. 

Normally, ct will hang up the current line, so that that line can answer the incoming call. The -h option 
will prevent this action. If the -v option is used, ct will send a running narrative to the standard error out¬ 
put stream. 

The data rate may be set with the -s option, where speed is expressed in baud. The default rate is 300. 

After the user on the destination terminal logs out, ct prompts. Reconnect? If the response begins with the 
letter n the line will be dropped; otherwise, getty will be started again and the login: prompt will be printed. 

Of course, the destination terminal must be attached to a modem that can answer the telephone. 

FILES 

/usr/lib/uucp/L-devices 

/usr/adm/ctlog 

SEE ALSO 

cu(lC), login(l), uucp(lC). 
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NAME 

cu - call another UNIX System 

SYNOPSIS 

cu [ -sspeed ] [ -lline ] [ -h ] [ -t ] [ -d ] [ -m ] [ -o I -e ] telno I dir 
DESCRIPTION 

Cu calls up another UNIX System, a terminal, or possibly a non-UNIX System. It manages an interactive 
conversation with possible transfers of ASCII files. Speed gives the transmission speed (110, 150, 300, 600, 
1200, 4800, 9600); 300 is the default value. Most of our modems are either 300 or 1200 baud. For dial out 
lines, cu will choose a modem speed (300 or 1200) as the slowest available which will handle the specified 
transmission speed. Directly connected lines may be set to speeds higher than 1200 baud. 

The -1 value may be used to specify a device name for the communications line device to be used. This can 
be used to override searching for the first available line having the right speed. The speed of a line is taken 
from the file /usr/lib/uucp/L-devices , overriding any speed specified by the -s option. The -h option emu¬ 
lates local echo, supporting calls to other computer systems which expect terminals to be in half-duplex 
mode. The -t option is used when dialing an ASCII terminal which has been set to auto-answer. Appropri¬ 
ate mapping of carriage-returns to carriage-return-line-feed pairs is set. The -d oprtion cause diagnostic 
traces to be printed. The -m option specifies a direct line which has modem control. The -e (-o) option 
designates that even (odd) parity is to be generated for data sent to the remote. The -d option causes diag¬ 
nostic traces to be printed. Telno is the telephone number, with equal signs for secondary dial tone or 
minus signs for delays, at appropriate places. The string dir for telno may be used for directly connected 
lines, and implies a null ACU. Using dir insures that a line has been specified by the -1 option. 

Cu will try each line listed in the file /usr/lib/uucp/L-devices until it finds an available line with appropriate 
attributes or runs out of entries. After making the connection, cu runs as two processes: the transmit pro¬ 
cess reads data from the standard input and, except for lines beginning with ~, passes it to the remote sys¬ 
tem; the receive process accepts data from the remote system and, except for lines beginning with ~, passes 
it to the standard output. Normally, an automatic DC3/DC1 protocol is used to control input from the 
remote so the buffer is not overrun. Lines beginning with ” have special meanings. 

The transmit process interprets the following: 

terminate the conversation. 

escape to an interactive shell on the local system. 

run cmd on the local system (via sh -c). 

run cmd locally and send its output to the remote system. 

copy file from (on the remote system) to file to on the local system. If to is omit¬ 
ted, the from argument is used in both places. 

copy file from (on local system) to file to on remote system. If to is omitted, the 
from argument is used in both places. 

send the line ”... to the remote system. 

turn off the DC3/DC1 input control protocol for the remainder of the session. This 
is useful in case the remote system is one which does not respond properly to the 
DC3 and DCl characters. 

The receive process normally copies data from the remote system to its standard output. A line from the 
remote that begins with ~> initiates an output diversion to a file. The complete sequence is: 

~>[>]:file 

zero or more lines to be written to file 
~> 

Data from the remote is diverted (or appended, if » is used) to file. The trailing ~> terminates the diver¬ 
sion. 


land... 

'$cmd... 

'%tak e from [ to ] 
'%put from [ to ] 

'% nostop 
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The use of ~%put requires stty( 1) and cat( 1) on the remote side. It also requires that the current erase and 
kill characters on the remote system be identical to the current ones on the local system. Backslashes are 
inserted at appropriate places. 

The use of ~%take requires the existence of echo( I) and cat( 1) on the remote system. Also, stty tabs 
mode should be set on the remote system if tabs are to be copied without expansion. 

FILES 

/usr/lib/uucp/L-devices 
/usr/spool/uucp/LCK.. (tty-device) 

/dev/null 

SEE ALSO 

cat(l), ct(lC), echo(l), stty(l), uucp(lC). 

DIAGNOSTICS 

Exit code is zero for normal exit, non-zero (various values) otherwise. 

BUGS 

Cm buffers input internally. 

There is an artificial slowing of transmission by cm during the ~%put operation so that loss of data is 
unlikely. 
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NAME 

cut - cut out selected fields of each line of a file 
SYNOPSIS 

cut -clist [ filel file2 ...] 

cut-flist [-dchar] [-s] [filel file2 ...] 

DESCRIPTION 

Use cut to cut out columns from a table or fields from each line of a file; in data base parlance, it imple¬ 
ments the projection of a relation. The fields as specified by list can be fixed length, i.e., character positions 
as on a punched card (-c option), or the length can vary from line to line and be marked with a field delim¬ 
iter character like tab (-f option). Cut can be used as a filter; if no files are given, the standard input is 
used. 

The meanings of the options are; 

list A comma-separated list of integer field numbers (in increasing order), with optional - to indicate 
ranges as in the -o option of nroffItroff for page ranges; e.g., 1,4,7; 1-3,8; -5,10 (short for 1-5,10); 
or 3- (short for third through last field). 

-c list The list following -c (no space) specifies character positions (e.g., -cl-72 would pass the first 72 
characters of each line). 

-f list The list following -f is a list of fields assumed to be separated in the file by a delimiter character 
(see -d ); e.g. , -fl,7 copies the hist and seventh held only. Lines with no held delimiters will be 
passed through intact (useful for table subheadings), unless -s is specihed. 

-d char The character following -d is the held delimiter (-f option only). Default is tab. Space or other 
characters with special meaning to the shell must be quoted. 

-s Suppresses lines with no delimiter characters in case of -f option. Unless specihed, lines with no 
delimiters will be passed through untouched. 

Either the -c or -f option must be specihed. 

HINTS 

Use grep( 1) to make horizontal “cuts” (by context) through a hie, or paste( 1) to put hies together 
column-wise (i.e., horizontally). To reorder columns in a table, use cut and paste. 

EXAMPLES 

cut -d: —f 1,5 /etc/passwd mapping of user IDs to names 

name=' who am i I cut -fl -d" " v to set name to current login name. 

DIAGNOSTICS 

line too long A line can have no more than 511 characters or helds. 

bad list for c/f option 

Missing -c or -f option or incorrectly specihed list. No error occurs if a line has 
fewer helds than the list calls for. 

no fields The list is empty. 

SEE ALSO 

grep(l), paste(l). 
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NAME 

cw, checkcw - prepare constant-width text for troff 
SYNOPSIS 

cw [ -lxx ] [ -rxx ] [ -fn ] [ -t ] [ +t ] [ -d ] [ files ] 
checkcw [ -lxx ] [ -rxx ] files 
DESCRIPTION 

Cw is a preprocessor for troff (1) input files that contain text to be typeset in the constant-width (CW) font. 

Text typeset with the CW font resembles the output of terminals and of line printers. This font is used to 
typeset examples of programs and of computer output in user manuals, programming texts, etc. (An earlier 
version of this font was used in typesetting The C Programming Language by B. W. Kernighan and D. M. 
Ritchie.) It has been designed to be quite distinctive (but not overly obtrusive) when used together with the 
Times Roman font. 

Because the CW font contains a “non-standard” set of characters and because text typeset with it requires 
different character and inter-word spacing than is used for “standard” fonts, documents that use the CW 
font must be preprocessed by cw. 

The CW font contains the 94 printing ASCII characters: 

abcdefghijklmnopqrstuvwxyz 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 

0123456789 

!$%&()" *+(§>.,/:;=?[] I -_~"o{ }# 

plus eight non-ASCII characters represented by four-character troff ( 1) names (in some cases attaching these 
names to “non-standard” graphics): 


Character Symbol Troff Name 


“Cents” sign 


%%(ct% 

EBCDIC “not” sign 

%1% 

%%(no% 

Left arrow 

%<-% 

%%(<-% 

Right arrow 

%-»% 

%%(->% 

Down arrow 

%i% 

%%(da% 

Vertical single quote 

%'% 

%%(fm% 

Control-shift indicator 

%f% 

%%(dg% 

Visible space indicator 

%□% 

%%(sq% 

Hyphen 

%-% 

%%(hy% 


The hyphen is a synonym for the unadorned minus sign (-). Certain versions of cw recognize two addi¬ 
tional names: %\(ua% for an up arrow and %\(lh% for a diagonal left-up (home) arrow. 

Cw recognizes five request lines, as well as user-defined delimiters. The request lines look like troff{ 1) 
macro requests, and are copied in their entirety by cw onto its output; thus, they can be defined by the user 
as troff( 1) macros; in fact, the %.CW% and %.CN% macros should be so defined (see HINTS below). The 
five requests are: 

.CW Start of text to be set in the CW font; %.CW% causes a break; it can take precisely the same 
options, in precisely the same format, as are available on the cw command line. 

.CN End of text to be set in the CW font; %.CN% causes a break; it can take the same options as are 
available on the cw command line. 

.CD Change delimiters and/or settings of other options; takes the same options as are available on the 
cw command line. 

.CP argl arg2 arg3 ... argn 

All the arguments (which are delimited like troff{ 1) macro arguments) are concatenated, with the 
odd-numbered arguments set in the CW font and the even-numbered ones in the prevailing font. 
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.PC argl arg2 arg3 ... argil 

Same as %.CP%, except that the even-numbered arguments are set in the CW font and the odd- 
numbered ones in the prevailing font. 

The %.CW% and %.CN% requests are meant to bracket text (e.g., a program fragment) that is to be typeset 
in the CW font “as is.” Normally, cw operates in the transparent mode. In that mode, except for the 
%.CD% request and the nine special four-character names listed in the table above, every character between 
%.CW% and %.CN% request lines stands for itself. In particular, cw arranges for periods (.) and apostro¬ 
phes (’) at the beginning of lines, and backslashes (%) everywhere to be “hidden” from trojfi I). The 
transparent mode can be turned off (see below), in which case normal troff(l) rules apply; in particular, 
lines that begin with %.% and %’% are passed through untouched (except if they contain delimiters-see 
below). In either case, cw hides the effect of the font changes generated by the %.CW% and %.CN% 
requests; cw also defeats all ligatures (%fi%, %ff%, etc.) in the CW font. 

The only purpose of the %.CD% request is to allow the changing of various options other than just at the 
beginning of a document. 

The user can also define delimiters. The left and right delimiters perform the same function as the 
%.CW%/%.CN% requests; they are meant, however, to enclose CW “words” or “phrases” in running text 
(see example under BUGS below). Cw treats text between delimiters in the same manner as text enclosed 
by %.CW%/%.CN% pairs, except that, for aesthetic reasons, spaces and backspaces inside 
%.CW%/%.CN% pairs have the same width as other CW characters, while spaces and backspaces between 
delimiters are half as wide, so they have the same width as spaces in the prevailing text (but are not 
adjustable). Font changes due to delimiters are not hidden. 

Delimiters have no special meaning inside %.CW%/%.CN% pairs. 

The options are: 

-hex The one- or two-character string xx becomes the left delimiter; if xx is omitted, the left delimiter 
becomes undefined, which it is initially. 

-rxx Same for the right delimiter. The left and right delimiters may (but need not) be different. 

-in The CW font is mounted in font position n ; acceptable values for n are 1, 2, and 3 (default is 3, 

replacing the bold font). This option is only useful at the beginning of a document. 

-t Turn transparent mode off. 

+t Turn transparent mode on (this is the initial default). 

-d Print current option settings on file descriptor 2 in the form of troff(l) comment lines. This option 

is meant for debugging. 

Cw reads the standard input when no files are specified (or when - is specified as the last argument), so it 
can be used as a filter. Typical usage is: 

cw files I troff ... 

Checkcw checks that left and right delimiters, as well as the %.CW%/%.CN% pairs, are properly balanced. 
It prints out all offending lines. 
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HINTS 

Typical definitions of the %.CW% and %.CN% macros meant to be used with the mm( 5) macro package: 

At the very least, the %.CW% macro should invoke the trojf( I) no-fill (% nf%) mode. 

When set in running text, the CW font is meant to be set in the same point size as the rest of the text. In dis¬ 
played matter, on the other hand, it can often be profitably set one point smaller than the prevailing point 
size (the displayed definitions of %.CW% and %.CN% above are one point smaller than the running text on 
this page). The CW font is sized so that, when it is set in 9-point, there are 12 characters per inch. 

Documents that contain CW text may also contain tables and/or equations. If this is the case, the order of 
preprocessing should be: cw, tbl, and eqn. Usually, the tables contained in such documents will not con¬ 
tain any CW text, although it is entirely possible to have elements of the table set in the CW font; of course, 
care must be taken that tbl(Y) format information not be modified by cw. Attempts to set equations in the 
CW font are not likely to be either pleasing or successful. 

In the CW font, overstriking is most easily accomplished with backspaces: letting %<— % represent a back¬ 
space, %A<r-<r- dg% yields (Because backspaces are half as wide between delimiters as inside 

%.CW%/%.CN% pairs-see above-two backspaces are required for each overstrike between delimiters.) 

FILES 

/usr/lib/font/ftCW CW font-width table 
SEE ALSO 

eqn(l), mmt(l), tbl(l), troffi l), mm(5), mv(5). 

WARNINGS 

If text preprocessed by cw is to make any sense, it must be set on a typesetter equipped with the CW font or 
on a STARE facility; on the latter, the CW font appears as bold, but with the proper CW spacing. 

BUGS 

Only a masochist would use periods (%.%), backslashes (%), or double quotes (%"%) as delimiters, or as 
arguments to %.CP% and %.PC%. 

Certain CW characters don’t concatenate gracefully with certain Times Roman characters, e.g., a CW 
ampersand (%&%) followed by a Times Roman comma(%,%); in such cases, judicious use of troff(Y) half- 
and quarter-spaces (%% and %%) is most salutary, e.g., one should use %_&_,% (rather than just plain 
%_&_,%) to obtain %&%, (assuming that %_% is used for both delimiters). 

Using cw with nroff is silly. 

The output of cw is hard to read. 

See also BUGS under troffi I). 
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NAME 

cxref - generate C program cross reference 

SYNOPSIS 

cxref [ options ] files 

DESCRIPTION 

Cxref analyzes a collection of C files and attempts to build a cross reference table. Cxref utilizes a special 
version of cpp to include #define’d information in its symbol table. It produces a listing on standard output 
of all symbols (auto, static, and global) in each file separately, or with the -c option, in combination. Each 
symbol contains an asterisk (*) before the declaring reference. 

In addition to the -D, -I and -U options (which are identical to their interpretation by cc(l)), the following 
options are interpreted by cxref: 

-c Print a combined cross-reference of all input files. 

-w<num> 

Width option which formats output no wider than <num> (decimal) columns. This option will 
default to 80 if <num> is not specified or is less than 51. 

-o file Direct output to named file. 

-s Operate silently; does not print input file names. 

-t Format listing for 80-column width. 

FILES 

/usr/lib/xcpp special version of C-preprocessor. 

SEE ALSO 

cc(l). 

DIAGNOSTICS 

Error messages are unusually cryptic, but usually mean that you can’t compile these files, anyway. 
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NAME 

date - print and set the date 

SYNOPSIS 

date [ mmddhhmm[yy] ] [ +format ] 

DESCRIPTION 

If no argument is given, or if the argument begins with +, the current date and time are printed. Otherwise, 
the current date is set. The first mm is the month number; dd is the day number in the month; lili is the 
hour number (24 hour system); the second mm is the minute number; yy is the last 2 digits of the year num¬ 
ber and is optional. For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. The current year is the default if no year is mentioned. The system oper¬ 
ates in GMT. Date takes care of the conversion to and from local standard and daylight time. 

If the argument begins with +, the output of date is under the control of the user. The format for the output 
is similar to that of the first argument to printf( 3S). All output fields are of fixed size (zero padded if neces¬ 
sary). Each field descriptor is preceded by % and will be replaced in the output by its corresponding value. 
A single % is encoded by % %. All other characters are copied to the output without change. The string is 
always terminated with a new-line character. 

Field Descriptors: 

n insert a new-line character 

t insert a tab character 

m month of year - 01 to 12 
d day of month - 01 to 31 
y last 2 digits of year - 00 to 99 
D date as mm/dd/yy 

H hour - 00 to 23 

M minute - 00 to 59 

S second - 00 to 59 

T time as HH:MM:SS 

j day of year - 001 to 366 
w day of week - Sunday = 0 

a abbreviated weekday - Sun to Sat 
h abbreviated month - Jan to Dec 
r time in AM/PM notation 

EXAMPLE 

date 4-DATE: %m/%d/%y%nTIME: %H:%M:%S' 
would have generated as output: 

DATE: 08/01/76 
TIME: 14:45:05 

DIAGNOSTICS 

No permission if you aren't the super-user and you try to change the date; 

bad conversion if the date set is syntactically incorrect; 

bad format character if the field descriptor is not recognizable. 

FILES 

/dev/kmem 

WARNING 

It is a bad practice to change the date while the system is running multi-user. 
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NAME 

dc - desk calculator 

SYNOPSIS 

dc [ file ] 

DESCRIPTION 

Dc is an arbitrary precision arithmetic package. Ordinarily it operates on decimal integers, but one may 
specify an input base, output base, and a number of fractional digits to be maintained. The overall structure 
of dc is a stacking (reverse Polish) calculator. If an argument is given, input is taken from that file until its 
end, then from the standard input. The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is an unbroken string of the digits 0-9. 
It may be preceded by an underscore (_) to input a negative number. Numbers may contain decimal 
points. 

+ -/*%' 

The top two values on the stack are added (+), subtracted (-), multiplied (*), divided (/), remain¬ 
dered (%), or exponentiated Q. The two entries are popped off the stack; the result is pushed on 
the stack in their place. Any fractional part of an exponent is ignored. 

sx The top of the stack is popped and stored into a register named x, where x may be any character. If 
the s is capitalized, x is treated as a stack and the value is pushed on it. 

lx The value in register x is pushed on the stack. The register x is not altered. All registers start with 
zero value. If the 1 is capitalized, register x is treated as a stack and its top value is popped onto the 
main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains unchanged. P interprets the top of the 

stack as an ASCII string, removes it, and prints it. 

f All values on the stack are printed. 

q exits the program. If executing a string, the recursion level is popped by two. If q is capitalized, the 
top value on the stack is popped and the string execution level is popped by that value. 

x treats the top element of the stack as a character string and executes it as a string of dc commands. 

X replaces the number on the top of the stack with its scale factor. 

[... ] puts the bracketed ASCII string onto the top of the stack. 

O' >x =x 

The top two elements of the stack are popped and compared. Register x is evaluated if they obey 
the stated relation. 

v replaces the top element on the stack by its square root. Any existing fractional part of the argument 
is taken into account, but otherwise the scale factor is ignored. 

! interprets the rest of the line as a UNIX System command. 

c All values on the stack are popped. 

i The top value on the stack is popped and used as the number radix for further input. I pushes the 
input base on the top of the stack. 

o The top value on the stack is popped and used as the number radix for further output. 

O pushes the output base on the top of the stack. 

k the top of the stack is popped, and that value is used as a non-negative scale factor: the appropriate 
number of places are printed on output, and maintained during multiplication, division, and expo¬ 
nentiation. The interaction of scale factor, input base, and output base will be reasonable if all are 


Page 1 



DC(1) 


DC(1) 


changed together. 

z The stack level is pushed onto the stack. 

Z replaces the number on the top of the stack with its length. 

? A line of input is taken from the input source (usually the terminal) and executed. 

; : are used by be for array operations. 

EXAMPLE 

This example prints the first ten values of n!: 

[lal+dsa*plalO>y]sy 

Osal 

lyx 

SEE ALSO 

bc(l), which is a preprocessor for dc providing infix notation and a C-like syntax which implements func¬ 
tions and reasonable control structures for programs. 

DIAGNOSTICS 

x is unimplemented 

where x is an octal number. 

stack empty 

for not enough elements on the stack to do what was asked. 

Out of space 

when the free list is exhausted (too many digits). 

Out of headers 

for too many numbers being kept around. 

Out of pushdown 

for too many items on the stack. 

Nesting Depth 

for too many levels of nested execution. 
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NAME 

dd - convert and copy a file 

SYNOPSIS 

dd [option=value] ... 

DESCRIPTION 

Dd copies the specified input file to the specified output with possible conversions. The standard input and 
output are used by default. The input and output block size may be specified to take advantage of raw 
physical I/O. 

option values 

if-file input file name; standard input is default 

of =file output file name; standard output is default 

ibs=« input block size n bytes (default 512) 

obs=n output block size (default 512) 

bs=« set both input and output block size, superseding ibs and obs; also, if no conversion is 

specified, it is particularly efficient since no in-core copy need be done 
cbs=n conversion buffer size 

skip=n skip n input records before starting copy 

seek=n seek n records from beginning of output file before copying 

count=« copy only n input records 

conv=ascii convert EBCDIC to ASCII 

ebcdic convert ASCII to EBCDIC 

ibm slightly different map of ASCII to EBCDIC 
lease map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 

noerror 

do not stop processing on an error 
sync pad every input record to ibs 
....... several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. A number may end with k, b, or w to specify 
multiplication by 1024, 512, or 2 respectively; a pair of numbers may be separated by x to indicate a prod¬ 
uct. 

Cbs is used only if ascii or ebcdic conversion is specified. In the former case ebs characters are placed into 
the conversion buffer, converted to ASCII, and trailing blanks trimmed and new-line added before sending 
the line to the output. In the latter case ASCII characters are read into the conversion buffer, converted to 
EBCDIC, and blanks added to make up an output record of size cbs. 

After completion, dd reports the number of whole and partial input and output blocks. 

EXAMPLE 

This command will read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record into the 
ASCII file x: 

dd if=/dev/rmtO of=x ibs=800 cbs=80 conv=ascii,lcase 

Note the use of raw magtape. Dd is especially suited to I/O on the raw physical devices because it allows 
reading and writing in arbitrary record sizes. 

SEE ALSO 

cp(l). 
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DIAGNOSTICS 

f+p records in(out) numbers of full and partial records read(written) 

BUGS 

The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the CACM Nov, 1968. 
The ibm conversion, while less blessed as a standard, corresponds better to certain IBM print train conven¬ 
tions. There is no universal solution. 

New-lines are inserted only on conversion to ASCII; padding is done only on conversion to EBCDIC. These 
should be separate options. 
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NAME 

delta - make a delta (change) to an SCCS file 
SYNOPSIS 

delta [-rSID] [-s] [—n] [—glist] [-m[mrlist]] [-y[comment]] [-p] files 
DESCRIPTION 

Delta is used to permanently introduce into the named SCCS file changes that were made to the file 
retrieved by get{ 1) (called the g-file, or generated file). 

Delta makes a delta to each named SCCS file. If a directory is named, delta behaves as though each file in 
the directory were specified as a named file, except that non-SCCS files (last component of the path name 
does not begin with s.) and unreadable files are silently ignored. If a name of - is given, the standard input 
is read (see WARNINGS)', each line of the standard input is taken to be the name of an SCCS file to be pro¬ 
cessed. 

Delta may issue prompts on the standard output depending upon certain keyletters specified and flags (see 
admin) 1)) that may be present in the SCCS file (see -m and -y keyletters below). 

Keyletter arguments apply independently to each named file. 

-r SID Uniquely identifies which delta is to be made to the SCCS file. The use of this 

keyletter is necessary only if two or more outstanding get s for editing (get -e) on 
the same SCCS file were done by the same person (login name). The SID value 
specified with the -r keyletter can be either the SID specified on the get command 
line or the SID to be made as reported by the get command (see get{ 1)). A diag¬ 
nostic results if the specified SID is ambiguous, or, if necessary and omitted on the 
command line. 

-s Suppresses the issue, on the standard output, of the created delta’s SID, as well as 

the number of lines inserted, deleted and unchanged in the SCCS file. 

-n Specifies retention of the edited g-file (normally removed at completion of delta 

processing). 

-glist Specifies a list (see get( 1) for the definition of list) of deltas which are to be 

ignored when the file is accessed at the change level (SID) created by this delta. 

-m [mrlist] If the SCCS file has the v flag set (see admin) 1)) then a Modification Request (MR) 

number must be supplied as the reason for creating the new delta. 

If -m is not used and the standard input is a terminal, the prompt MRs? is issued 
on the standard output before the standard input is read; if the standard input is not 
a terminal, no prompt is issued. The MRs? prompt always precedes the 
comments? prompt (see -y keyletter). 

MRs in a list are separated by blanks and/or tab characters. An unescaped new- 
line character terminates the MR list. 

Note that if the v flag has a value (see admin) 1)), it is taken to be the name of a 
program (or shell procedure) which will validate the correctness of the MR num¬ 
bers. If a non-zero exit status is returned from MR number validation program, 
delta terminates (it is assumed that the MR numbers were not all valid). 

-y [comment] Arbitrary text used to describe the reason for making the delta. A null string is 

considered a valid comment. 

If -y is not specified and the standard input is a terminal, the prompt comments? 
is issued on the standard output before the standard input is read; if the standard 
input is not a terminal, no prompt is issued. An unescaped new-line character ter¬ 
minates the comment text. 
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-p Causes delta to print (on the standard output) the SCCS file differences before and 

after the delta is applied in a diff(Y) format. 


FILES 

All files of the form ?-file are explained in the Source Code Control System User’s Guide. The naming 
convention for these files is also described there. 

g-file Existed before the execution of delta ; removed after completion of delta. 

p-file Existed before the execution of delta ; may exist after completion of delta. 

q-file Created during the execution of delta ; removed after completion of delta. 

x-file Created during the execution of delta ; renamed to SCCS file after completion of delta. 

z-file Created during the execution of delta ; removed during the execution of delta. 

d-file Created during the execution of delta ; removed after completion of delta. 

/usr/bin/bdiff Program to compute differences between the ‘ ‘gotten' ’ file and the g-file. 

WARNINGS 

Lines beginning with an SOH ASCII character (binary 001) cannot be placed in the SCCS file unless the 
SOH is escaped. This character has special meaning to SCCS (see sccsfile( 5)) and will cause an error. 

A get of many SCCS files, followed by a delta of those files, should be avoided when the get generates a 
large amount of data. Instead, multiple get/delta sequences should be used. 

If the standard input (-) is specified on the delta command line, the -m (if necessary) and -y keyletters 
must also be present. Omission of these keyletters causes an error to occur. 

Comments are limited to text strings of at most 512 characters. 


SEE ALSO 

admin(l), bdiff(l), cdc(l), get(l), help(l), prs(l), rmdel(l), sccsfile(4). 

Source Code Control System User’s Guide in the UNIX System User’s Guide. 


DIAGNOSTICS 

Use help( 1) for explanations. 
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NAME 

deroff - remove nroff/troff, tbl, and eqn constructs 
SYNOPSIS 

deroff | -mx ] [ -w ] [ files ] 

DESCRIPTION 

Deroff reads each of the files in sequence and removes all troff(l) requests, macro calls, backslash con¬ 
structs, eqn( 1) constructs (between .EQ and JEN lines, and between delimiters), and tbl( 1) descriptions, per¬ 
haps replacing them with white space (blanks and blank lines), and writes the remainder of the file on the 
standard output. Deroff follows chains of included files (.so and .nx troff commands); if a file has already 
been included, a .so naming that file is ignored and a .nx naming that file terminates execution. If no input 
file is given, deroff reads the standard input. 

The -m option may be followed by an m, s, or 1. The -mm option causes the macros be interpreted so that 
only running text is output (i.e., no text from macro lines.) The -ml option forces the -mm option and also 
causes deletion of lists associated with the mm macros. 

If the -w option is given, the output is a word list, one “word” per line, with all other characters deleted. 
Otherwise, the output follows the original, with the deletions mentioned above. In text, a “word” is any 
string that contains at least two letters and is composed of letters, digits, ampersands (&), and apostrophes 
('); in a macro call, however, a “word" is a string that begins with at least two letters and contains a total 
of at least three letters. Delimiters are any characters other than letters, digits, apostrophes, and amper¬ 
sands. Trailing apostrophes and ampersands are removed from “words.” 

SEE ALSO 

eqn(l), nroffd), tbl(l), troffd). 

BUGS 

Deroff is not a complete troff interpreter, so it can be confused by subtle constructs. Most such errors result 
in too much rather than too little output. 

The -ml option does not handle nested lists correctly. 
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NAME 

diff - differential file comparator 
SYNOPSIS 

diff [ -efbh ] filel file2 
DESCRIPTION 

Diff tells what lines must be changed in two files to bring them into agreement. If filel (file2) is the stan¬ 
dard input is used. If filel (file2) is a directory, then a file in that directory with the name file 2 (filel ) is 
used. The normal output contains lines of these forms: 

nl a n3,n4 
nl,n2 d n3 
nl,n2 c n3,n4 

These lines resemble ed commands to convert filel into file2. The numbers after the letters pertain to file2. 
In fact, by exchanging a for d and reading backward one may ascertain equally how to convert file2 into 
filel. As in ed, identical pairs where nl = n2 or n3 = n4 are abbreviated as a single number. 

Following each of these lines come all the lines that are affected in the first file flagged by <, then all the 
lines that are affected in the second file flagged by >. 

The -b option causes trailing blanks (spaces and tabs) to be ignored and other strings of blanks to compare 
equal. 

The -e option produces a script of a, c and d commands for the editor ed, which will recreate file2 from 
filel. The -f option produces a similar script, not useful with ed, in the opposite order. In connection with 
-e, the following shell program may help maintain multiple versions of a file. Only an ancestral file ($1) 
and a chain of version-to-version ed scripts ($2,$3,...) made by diff need be on hand. A “latest version" 
appears on the standard output. 

(shift; cat $*; echo 'l,$p') I ed - $1 

Except in rare circumstances, diff finds a smallest sufficient set of file differences. 

Option -h does a fast, half-hearted job. It works only when changed stretches are short and well separated, 
but does work on files of unlimited length. Options -e and -f are unavailable with -h. 

FILES 

/tmp/d????? 

/usr/lib/diffh for -h 

SEE ALSO 

cmp(l), comm(l), ed(l). 

DIAGNOSTICS 

Exit status is 0 for no differences, 1 for some differences, 2 for trouble. 

BUGS 

Editing scripts produced under the -e or -f option are naive about creating lines consisting of a single 
period (.). 
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NAME 

diff3 - 3-way differential file comparison 
SYNOPSIS 

difO [ -ex3 ] filel file2 file3 
DESCRIPTION 

Diff3 compares three versions of a file, and publishes disagreeing ranges of text flagged with these codes: 


:== 

all three files differ 

:==1 

filel is different 

==2 

file2 is different 

==3 

file3 is different 


The type of change suffered in converting a given range of a given file to some other is indicated in one of 
these ways: 

/: nl a Text is to be appended after line number nl in file/, where/ = 1, 2, or 3. 

/: nl , n2 c Text is to be changed in the range line nl to line n2. If nl = n 2, the range 

may be abbreviated to nl. 

The original contents of the range follows immediately after a c indication. When the contents of two files 
are identical, the contents of the lower-numbered file is suppressed. 

Under the -e option, diff3 publishes a script for the editor ed that will incorporate into filel all changes 
between file2 and file3, i.e., the changes that normally would be flagged ==== and ====3. Option -x (-3) 
produces a script to incorporate only changes flagged ==== (====3). The following command will apply 
the resulting script to filel. 

(cat script; echo 'l,$p') I ed - filel 

FII.ES 

/tmp/d3* 

/usr/lib/diff3prog 

SEE ALSO 

diff(l). 

BUGS 

Text lines that consist of a single . will defeat -e. 

Files longer than 64K bytes won’t work. 
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NAME 

diffmk - mark differences between files 
SYNOPSIS 

diffmk namel name2 name3 

DESCRIPTION 

Diffmk compares two versions of a file and creates a third file that includes ‘ ‘change mark’ ’ commands for 
nr off or: 1roff(\). Namel and name2 are the old and new versions of the file. Diffmk generates name3, 
which contains the lines of name2 plus inserted formatter “change mark" (.me) requests. When namel is 
formatted, changed or inserted text is shown by I at the right margin of each line. The position of deleted 
text is shown by a single *. 

If anyone is so inclined, diffmk can be used to produce listings of C (or other) programs with changes 
marked. A typical command line for such use is: 

diffmk old.c new.c tmp; nroff macs tmp I pr 

where the file macs contains: 

.pi 1 
.11 77 
.nf 
.eo 
.nc v 

The .11 request might specify a different line length, depending on the nature of the program being printed. 
The .eo and .nc requests are probably needed only for C programs. 

If the characters I and * are inappropriate, a copy of diffmk can be edited to change them (diffmk is a shell 
procedure). 

SEE ALSO 

diff(l), nroff(l), troffi l). 

BUGS 

Aesthetic considerations may dictate manual adjustment of some output. File differences involving only 
formatting requests may produce undesirable output, i.e., replacing .sp by .sp 2 will produce a “change 
mark' ’ on the preceding or following line of output. 
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NAME 

dircmp - directory comparison 
SYNOPSIS 

dircmp [ — d ] [ —s ] dirl dir2 
DESCRIPTION 

Dircmp examines dirl and dir2 and generates various tabulated information about the contents of the 
directories. Listings of files that are unique to each directory are generated for all the options. If no option 
is entered, a list is output indicating whether the filenames common to both directories have the same con¬ 
tents. 

-d Compare the contents of files with the same name in both directories and output a list telling what 
must be changed in the two files to bring them into agreement. The list format is described in 

dm i). 

-s Suppress messages about identical files. 

SEE ALSO 

cmp(l), diff(T). 


Page 1 



DIS(l) 


(3B20S only) 


DIS(l) 


NAME 

dis - 3B20S disassembler 

SYNOPSIS 

dis [-o] [-V] [-L] [-d sec] [-da sec ] [-t sec] [-1 string] files 

DESCRIPTION 

The dis command produces an assembly language listing of each of its object file arguments. The listing 
includes assembly statements and the binary that produced those statements. 

The following options are interpreted by the disassembler and may be specified in any order. 

-o Will print numbers in octal. Default is hexadecimal. 

-V Version number of the disassembler will be written to standard error. 

-L Invokes a lookup of C source labels in the symbol table for subsequent printing. 

-d sec Disassembles the named section as data, printing the offset of the data from the beginning of 

the section. 

-da sec Disassembles the named section as data, printing the actual address of the data. 

-t sec Disassembles the named section as text. 

-1 string Will disassemble the library file specified as string. For example, one would issue the com¬ 
mand dis -1 x -1 z to disassemble libx.a and libz.a. All libraries are assumed to be in 

/usr/lib. 

If the -d, -da or -t options are specified, only those named sections from each user supplied file name will 
be disassembled. Otherwise, all sections containing text will be disassembled. 

On output, a number enclosed in brackets at the beginning of a line, such as [5], represents that the C break- 
pointable line number, starts with the following instruction. An expression such as <40> in the operand 
field, following a relative displacement for control transfer instructions, is the computed address within the 
section to which control will be transferred. A C function name will appear in the first column, followed by 
()• 

SEE ALSO 

as(l), cc(l), ld(l). 

DIAGNOSTICS 

The self explanatory diagnostics indicate errors in the command line or problems encountered with the 
specified files. 
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NAME 

dpd, lpd - HONEYWELL sending daemon, line printer daemon 

SYNOPSIS 

/usr/Iib/dpd 

/usr/lib/lpd 

DESCRIPTION 

Dpd is the daemon for the 200-series DATA-PHONE nh 


data set or for a KMCll-B using vpm( 7). It is designed to submit jobs to the HONEYWELL 6000 computer 
via the GRTS interface. Lpd is the daemon for a line printer. 

Dpd uses the directory /usr/spool/dpd. Lpd uses the directory /usr/spool/lpd. The file lock in either 
directory is used to prevent two daemons from becoming active simultaneously. After the program has suc¬ 
cessfully set the lock, it forks and the main path exits, thus spawning the daemon. The directory is scanned 
for files beginning with “df". Each such file is submitted as a job. Each line of a job file must begin with 
a key character to specify what to do with the remainder of the line. 

S directs dpd to generate a unique snumb card. The snumb number is generated from the file snumb 

in the spooling directory in the case of the DATA-PHONE data set daemon. This key character is 
not used by lpd. 

L specifies that the remainder of the line is to be sent as a literal. 

I is the same as L, but signals the $ IDENT card which is to be mailed back by the mail option. 

B specifies that the rest of the line is a file name. That file is to be sent as binary cards. 

F is the same as B except a form-feed is prepended to the file. 

U specifies that the rest of the line is a file name. After the job has been transmitted, the file is 
unlinked. 

M is followed by a user ID; after the job is sent, a message is mailed to the user via the mail( 1) com¬ 
mand to verify the sending of the job. 

N is followed by a user file name, to be sent back under the mail option. 

Q is followed by a string of characters, which is a message to be sent back to the user under the mail 

option. (Not used by lpd). 

Any error encountered will cause the daemon to drop the call, wait up to 20 minutes, (only 10 seconds for 
lpd), and start over. This means that an improperly constructed “df" file may cause the same job to be 
submitted every 20 minutes. 

Dpd is automatically initiated by all of the GCOS commands (dpr, gcat, gcosmail , fget , and fsend). Lpd is 
automatically initiated by the line printer command, Ipr. 

To restart dpd or lpd (in the case of hardware or software malfunction), it is necessary to first kill the old 
daemon (if it is still alive), and remove the lock file (if present), before initiating the new daemon. This can 
be done automatically by /etc/rc when the system is brought up, in the event there were jobs left in the 
spooling directory when the system last went down. 


FILES 

/usr/spool/dpd/* 

/usr/spool/lpd/* 

/etc/passwd 

/dev/dn? 

/dev/du? 

/dev/vpm? 

/dev/lp 


spool area for GCOS daemons, 
spool area for line printer daemon, 
to get the user’s name. 

ACU device. 

DATA-PHONE data set. 

VPM device to interface to KMCl 1-B. 
line printer device. 


SEE ALSO 

dpr(lC), fget(lC), fsend(lC), gcat(lC), gcosmail(lC), lpr(l). 
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BUGS 

If a umask{ 1) of 077 is used, the print jobs may be spooled but won’t be able to be printed. 
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NAME 

dpr - off-line print 
SYNOPSIS 

dpr [ -destination ] [ options ] [ files ] 

DESCRIPTION 

Dpr causes the named files to be printed off-line at the specified destination, by GCOS at the Murray Hill 
Computation Center. GCOS identification must appear in the UNIX System password file (see passwd{ 4)), 
or be supplied by the -i option. If no files are listed the standard input is assumed; thus dpr may be used as 
a filter. 

The destination is a two-character code which is taken to be a Murray Hill GCOS “station id.” Useful 
codes are rl for quality print, and ql for quality print with special ribbon, both on regular wide paper. The 
codes r2 and q2 give the same print on narrow paper. The code mx is a Xerox 9700 printer. The default 
destination is on-line at the Murray Hill Computation Center. 

The following options, each as a separate argument, and in any combination (multiple outputs are permit¬ 
ted), may be given before or after the destination: 

-c Makes a copy of the file to be sent before returning to the user. 

-r Removes the file after sending it. 

-f file Use file as a dummy file name to report back in the mail. (This is useful for distinguishing multi¬ 

ple runs, especially when dpr is being used as a filter). 

-i job, bin 

Supply the GCOS “ident card" image as the parameter -ijob,bin where job is the GCOS job num¬ 
ber and bin the GCOS bin number or any comment to the GCOS operators. 

-m When transmission is complete, reports by mail( 1) the so-called snumb of the receiving GCOS job. 
The mail is sent by the UNIX daemon; there is no guarantee that the GCOS job ran successfully. 
This is the default option. 

-n Does not report the completion of transmission by mail{ 1). 

-p Selects portrait mode. Used in conjunction with a XEROX 9700 printer. 

-s n Submits job to GCOS with service grade n (n=l, 2, 3, 4). Default is -s2. 

EXAMPLES 

The command: 

dpr -r -n error 1 error2 

will send the files errorl and error2 to GCOS for printing, removing the files after they have been sent, but 
not sending mail. The line: 

pr filel I dpr -si -fjobl -rl 

will send the output of pr to GCOS for printing on the quality printer with service grade 1, and will send 
mail that jobl has been sent. 

FILES 

/etc/passwd user’s identification and GCOS ident card. 

/usr/lib/dpd sending daemon. 

/usr/spool/dpd/* spool area. 

SEE ALSO 

dpd(lC), fget(lC), fsend(lC), gcat(lC). 
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NAME 

du - summarize disk usage 

SYNOPSIS 

du [ -ars ] [ names ] 

DESCRIPTION 

Du gives the number of blocks contained in all files and (recursively) directories within each directory and 
file specified by the names argument. The block count includes the indirect blocks of the file. If names is 
missing,. is used. 

The optional argument -s causes only the grand total (for each of the specified names) to be given. The 
optional argument -a causes an entry to be generated for each file. Absence of either causes an entry to be 
generated for each directory only. 

Du is normally silent about directories that cannot be read, files that cannot be opened, etc. The -r option 
will cause du to generate messages in such instances. 

A file with two or more links is only counted once. 

BUGS 

If the -a option is not used, non-directories given as arguments are not listed. 

If there are too many distinct linked files, du will count the excess files more than once. 

Files with holes in them will get an incorrect block count. 
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NAME 

dump - dump selected parts of an object file 
SYNOPSIS 

dump [-a] [—f] [—o] [-h] [-s] [—r] [-1] [-t] [-z name] files 
DESCRIPTION 

The dump command dumps selected parts of each of its object file arguments. 

This command will accept both object files and archives of object files. It processes each file argument 
according to one or more of the following options: 

-a Dump the archive header of each member of each archive file argument. 

-f Dump each file header. 

-o Dump each optional header. 

-h Dump section headers. 

-s Dump section contents. 

-r Dump relocation information. 

-1 Dump line number information. 

-t Dump symbol table entries. 

-z name Dump line number entries for the named function. 

The following modifiers are used in conjunction with the options listed above to modify their capabilities. 

-d number Dump the section number or range of sections starting at number and ending either at the last 
section number or number specified by +d. 

+d number Dump sections in the range either beginning with first section or beginning with section 
specified by -d. 

-n name Dump information pertaining only to the named entity. This modifier applies to -h, -s, -r, -1, 
and -t. 

-t index Dump only the indexed symbol table entry. The -t used in conjunction with +t, specifies a 
range of symbol table entries. 

+t index Dump the symbol table entries in the range ending with the indexed entry. The range begins at 
the first symbol table entry or at the entry specified by the -t option. 

-v Dump information in symbolic representation rather than numeric (e.g., C STATIC instead of 

0X02). This modifier can be used with all the above options except -s and -o options of dump. 

-z name.number 

Dump line number entry or range of line numbers starting at number for the named function. 

+z number 

Dump line numbers starting at either function name or number specified by -z, up to number 
specified by +z. 

Blanks separating an option and its modifier are optional. The comma separating the name from the num¬ 
ber modifying the -z option may be replaced by a blank. 

The dump command attempts to format the information it dumps in a meaningful way, printing certain 
information in character, hex, octal or decimal representation as appropriate. 

SEE ALSO 

a.out(4), ar(4). 
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NAME 

echo - echo arguments 

SYNOPSIS 

echo [ arg ] ... 

DESCRIPTION 

Echo writes its arguments separated by blanks and terminated by a new-line on the standard output. It also 
understands C-like escape conventions; beware of conflicts with the shell’s use of \: 

\b backspace 

\c print line without new-line 

\f form-feed 

\n new-line 

\r carriage return 

\t tab 

\\ backslash 

\n the 8-bit character whose ASCII code is the 1-, 2- or 3-digit octal number n, which must 

start with a zero. 

Echo is useful for producing diagnostics in command files and for sending known data into a pipe. 

SEE ALSO 

sh(l). 
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NAME 

ed, red - text editor 

SYNOPSIS 

ed[-][-x] [file] 

red [ - ] [ -x ] [ file ] 

DESCRIPTION 

Ed is the standard text editor. If the file argument is given, ed simulates an e command (see below) on the 
named file; that is to say, the file is read into ed's buffer so that it can be edited. The optional - suppresses 
the printing of character counts by e, r, and w commands, of diagnostics from e and q commands, and of 
the ! prompt after a [shell command. If -x is present, an x command is simulated first to handle an 
encrypted file. Ed operates on a copy of the file it is editing; changes made to the copy have no effect on 
the file until a w (write) command is given. The copy of the text being edited resides in a temporary file 
called the buffer. There is only one buffer. 

Red is a restricted version of ed. It will only allow editing of files in the current directory. It prohibits exe¬ 
cuting shell commands via [shell command. Attempts to bypass these restrictions result in an error mes¬ 
sage ( restricted shell). 

Both ed and red support the fspec(4) formatting capability. After including a format specification as the 
first line of file and invoking ed with your terminal in stty-tabs or stty tab3 mode (see stty{ 1), the 
specified tab stops will automatically be used when scanning file. For example, if the first line of a file con¬ 
tained: 

<:t5,10,15 s72:> 

tab stops would be set at columns 5, 10 and 15, and a maximum line length of 72 would be imposed. 
NOTE: while inputting text, tab characters when typed are expanded to every eighth column as is the 
default. 

Commands to ed have a simple and regular structure: zero, one, or two addresses followed by a single¬ 
character command, possibly followed by parameters to that command. These addresses specify one or 
more lines in the buffer. Every command that requires addresses has default addresses, so that the 
addresses can very often be omitted. 

In general, only one command may appear on a line. Certain commands allow the input of text. This text 
is placed in the appropriate place in the buffer. While ed is accepting text, it is said to be in input mode. In 
this mode, no commands are recognized; all input is merely collected. Input mode is left by typing a period 
(.) alone at the beginning of a line. 

Ed supports a limited form of regular expression notation; regular expressions are used in addresses to 
specify lines and in some commands (e.g., s) to specify portions of a line that are to be substituted. A regu¬ 
lar expression (RE) specifies a set of character strings. A member of this set of strings is said to be matched 
by the RE. The REs allowed by ed are constructed as follows: 

The following one-character REs match a single character: 

1.1 An ordinary character ( not one of those discussed in 1.2 below) is a one-character RE that matches 
itself. 

1.2 A backslash (Y) followed by any special character is a one-character RE that matches the special char¬ 
acter itself. The special characters are: 

a. ., *, [, and \ (period, asterisk, left square bracket, and backslash, respectively), which are always 
special, except when they appear within square brackets ([]; see 1.4 below). 

b. ~ (caret or circumflex), which is special at the beginning of an entire RE (see 3.1 and 3.2 below), 
or when it immediately follows the left of a pair of square brackets ([]) (see 1.4 below). 

c. $ (currency symbol), which is special at the end of an entire RE (see 3.2 below). 
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d. The character used to bound (i.e., delimit) an entire RE, which is special for that RE (for example, 
see how slash (/) is used in the g command, below.) 

1.3 A period (.) is a one-character RE that matches any character except new-line. 

1.4 A non-empty string of characters enclosed in square brackets ([]) is a one-character RE that matches 
any one character in that string. If, however, the first character of the string is a circumflex (~), the 
one-character RE matches any character except new-line and the remaining characters in the string. 
The ~ has this special meaning only if it occurs first in the string. The minus (-) may be used to indi¬ 
cate a range of consecutive ASCII characters; for example, [0-9] is equivalent to [0123456789]. The - 
loses this special meaning if it occurs first (after an initial /v , if any) or last in the string. The right 
square bracket (]) does not terminate such a string when it is the first character within it (after an ini¬ 
tial if any); e.g., []a-f] matches either a right square bracket (]) or one of the letters a through f 
inclusive. The four characters listed in 1.2.a above stand for themselves within such a string of char¬ 
acters. 

The following rules may be used to construct RE s from one-character REs; 

2.1 A one-character RE is a RE that matches whatever the one-character RE matches. 

2.2 A one-character RE followed by an asterisk (*) is a RE that matches zero or more occurrences of the 
one-character RE. If there is any choice, the longest leftmost string that permits a match is chosen. 

2.3 A one-character RE followed by \{m\], \{m,\], or \{ m,n\\ is a RE that matches a range of occurrences 
of the one-character RE. The values of m and n must be non-negative integers less than 256; \{m\] 
matches exactly m occurrences; \{m,\] matches at least m occurrences; \{m,n\} matches any number 
of occurrences between m and n inclusive. Whenever a choice exists, the RE matches as many occur¬ 
rences as possible. 

2.4 The concatenation of REs is a RE that matches the concatenation of the strings matched by each com¬ 
ponent of the RE. 

2.5 A RE enclosed between the character sequences \( and \) is a RE that matches whatever the unadorned 
RE matches. 

2.6 The expression \n matches the same string of characters as was matched by an expression enclosed 
between \( and \) earlier in the same RE. Here a is a digit; the sub-expression specified is that begin¬ 
ning with the n- th occurrence of \( counting from the left. For example, the expression W(.*\)\l$ 
matches a line consisting of two repeated appearances of the same string. 

Finally, an entire RE may be constrained to match only an initial segment or final segment of a line (or 
both): 

3.1 A circumflex (~) at the beginning of an entire RE constrains that RE to match an initial segment of a 
line. 

3.2 A currency symbol ($) at the end of an entire RE constrains that RE to match a final segment of a line. 
The construction /v entire RE% constrains the entire RE to match the entire line. 

The null RE (e.g., //) is equivalent to the last RE encountered. See also the last paragraph before FILES 
below. 

To understand addressing in ed it is necessary to know that at any time there is a current line. Generally 
speaking, the current line is the last line affected by a command; the exact effect on the current line is dis¬ 
cussed under the description of each command. Addresses are constructed as follows; 

1. The character . addresses the current line. 

2. The character $ addresses the last line of the buffer. 

3. A decimal number n addresses the «-th line of the buffer. 

4. 'x addresses the line marked with the mark name character x, which must be a lower-case letter. 
Fines are marked with the k command described below. 
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5. A RE enclosed by slashes (/) addresses the first line found by searching forward from the line 
following the current line toward the end of the buffer and stopping at the first line containing a string 
matching the RE. If necessary, the search wraps around to the beginning of the buffer and continues 
up to and including the current line, so that the entire buffer is searched. See also the last paragraph 
before FILES below. 

6. A RE enclosed in question marks (?) addresses the first line found by searching backward from the 
line preceding the current line toward the beginning of the buffer and stopping at the first line con¬ 
taining a string matching the RE. If necessary, the search wraps around to the end of the buffer and 
continues up to and including the current line. See also the last paragraph before FILES below. 

7. An address followed by a plus sign (+) or a minus sign (-) followed by a decimal number specifies 
that address plus (respectively minus) the indicated number of lines. The plus sign may be omitted. 

8. If an address begins with + or -, the addition or subtraction is taken with respect to the current line; 
e.g, -5 is understood to mean .-5. 

9. If an address ends with + or -, then 1 is added to or subtracted from the address, respectively. As a 
consequence of this rule and of rule 8 immediately above, the address - refers to the line preceding 
the current line. (To maintain compatibility with earlier versions of the editor, the character ~ in 
addresses is entirely equivalent to -.) Moreover, trailing + and - characters have a cumulative effect, 
so — refers to the current line less 2. 

10. For convenience, a comma (,) stands for the address pair 1,$, while a semicolon (;) stands for the pair 

Commands may require zero, one, or two addresses. Commands that require no addresses regard the pres¬ 
ence of an address as an error. Commands that accept one or two addresses assume default addresses when 
an insufficient number of addresses is given; if more addresses are given than such a command requires, the 
last one(s) are used. 

Typically, addresses are separated from each other by a comma (,). They may also be separated by a semi¬ 
colon (;). In the latter case, the current line (.) is set to the first address, and only then is the second 
address calculated. This feature can be used to determine the starting line for forward and backward 
searches (see rules 5. and 6. above). The second address of any two-address sequence must correspond to a 
line that follows, in the buffer, the line corresponding to the first address. 

In the following list of ed commands, the default addresses are shown in parentheses. The parentheses are 
not part of the address; they show that the given addresses are the default. 

It is generally illegal for more than one command to appear on a line. However, any command (except e,f, 
r, or w) may be suffixed by 1, n or p, in which case the current line is either listed, numbered or printed, 
respectively, as discussed below under the /, n and p commands. 

(,)a 

<text> 

The append command reads the given text and appends it after the addressed line; . is left at the 
last inserted line, or, if there were none, at the addressed line. Address 0 is legal for this com¬ 
mand: it causes the “appended” text to be placed at the beginning of the buffer. The maximum 
number of characters that may be entered from a terminal is 256 per line (including the newline 
character). 

(•)c 

<text> 

The change command deletes the addressed lines, then accepts input text that replaces these lines; 
. is left at the last line input, or, if there were none, at the first line that was not deleted. 

(.,.)d 

The delete command deletes the addressed lines from the buffer. The line after the last line 
deleted becomes the current line; if the lines deleted were originally at the end of the buffer, the 
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new last line becomes the current line. 

efile 

The edit command causes the entire contents of the buffer to be deleted, and then the named file to 
be read in; . is set to the last line of the buffer. If no file name is given, the currently-remembered 
file name, if any, is used (see the / command). The number of characters read is typed; file is 
remembered for possible use as a default file name in subsequent e , r, and w commands. If file is 
replaced by !, the rest of the line is taken to be a shell (s/z(l)) command whose output is to be read. 
Such a shell command is not remembered as the current file name. See also DIAGNOSTICS below. 

E file 

The Edit command is like e, except that the editor does not check to see if any changes have been 
made to the buffer since the last w command. 

f file 

If file is given, the/ile-name command changes the currently-remembered file name to file', other¬ 
wise, it prints the currently-remembered file name. 

(1, $ )g iRE/command list 

In the global command, the first step is to mark every line that matches the given RE. Then, for 
every such line, the given command list is executed with . initially set to that line. A single com¬ 
mand or the first of a list of commands appears on the same line as the global command. All lines 
of a multi-line list except the last line must be ended with a \; a, i, and c commands and associated 
input are permitted; the . terminating input mode may be omitted if it would be the last line of the 
command list. An empty command list is equivalent to the p command. The g, G, v, and V com¬ 
mands are not permitted in the command list. See also BUGS and the last paragraph before FILES 
below. 

(1,$)G IRE/ 

In the interactive Global command, the first step is to mark every line that matches the given RE. 
Then, for every such line, that line is printed, . is changed to that line, and any one command 
(other than one of the a, c, i, g, G, v, and V commands) may be input and is executed. After the 
execution of that command, the next marked line is printed, and so on; a new-line acts as a null 
command; an & causes the re-execution of the most recent command executed within the current 
invocation of G. Note that the commands input as part of the execution of the G command may 
address and affect any lines in the buffer. The G command can be terminated by an interrupt sig¬ 
nal (ASCII DEL or BREAK). 

h 

The help command gives a short error message that explains the reason for the most recent ? diag¬ 
nostic. 

H 

The //c lp command causes ed to enter a mode in which error messages are printed for all subse¬ 
quent ? diagnostics. It will also explain the previous ? if there was one. The H command alter¬ 
nately turns this mode on and off; it is initially off. 

(•)i 

<text> 


The insert command inserts the given text before the addressed line; . is left at the last inserted 
line, or, if there were none, at the addressed line. This command differs from the a command only 
in the placement of the input text. Address 0 is not legal for this command. The maximum num¬ 
ber of characters that may be entered from a terminal is 256 per line (including the newline charac¬ 
ter). 

The join command joins contiguous lines by removing the appropriate new-line characters. If 
exactly one address is given, this command does nothing. 
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(.)kv 

The mar k command marks the addressed line with name x, which must be a lower-case letter. The 
address 'x then addresses this line;. is unchanged. 

(.,.)! 

The /ist command prints the addressed lines in an unambiguous way: a few non-printing charac¬ 
ters (e.g., tab, backspace) are represented by (hopefully) mnemonic overstrikes, all other non¬ 
printing characters are printed in octal, and long lines are folded. An / command may be appended 
to any other command other than e,f, r, or w. 

(.,. )mfl 

The move command repositions the addressed line(s) after the line addressed by a. Address 0 is 
legal for a and causes the addressed line(s) to be moved to the beginning of the file; it is an error if 
address a falls within the range of moved lines;. is left at the last line moved. 

(.,.)n 

The number command prints the addressed lines, preceding each line by its line number and a tab 
character;. is left at the last line printed. The n command may be appended to any other command 
other than e,f, r, or w. 

(•, • )P 

The print command prints the addressed lines; . is left at the last line printed. The p command 
may be appended to any other command other than e , /, r, or w; for example, dp deletes the cur¬ 
rent line and prints the new current line. 

P 

The editor will prompt with a * for all subsequent commands. The P command alternately turns 
this mode on and off; it is initially off. 

q 

The guit command causes ed to exit. No automatic write of a file is done (but see DIAGNOSTICS 
below). 

Q 

The editor exits without checking if changes have been made in the buffer since the last w com¬ 
mand. 

($ )r file 

The read command reads in the given file after the addressed line. If no file name is given, the 
currently-remembered file name, if any, is used (see e and / commands). The currently- 
remembered file name is not changed unless file is the very first file name mentioned since ed was 
invoked. Address 0 is legal for r and causes the file to be read at the beginning of the buffer. If 
the read is successful, the number of characters read is typed; . is set to the last line read in. If file 
is replaced by !, the rest of the line is taken to be a shell (sh( 1)) command whose output is to be 
read. For example, "$r !ls" appends current directory to the end of the file being edited. Such a 
shell command is not remembered as the current file name. 

(.,. )s /RE I replacement! or 

(.,. )slRE I replacement Ig 

The substitute command searches each addressed line for an occurrence of the specified RE. In 
each line in which a match is found, all (non-overlapped) matched strings are replaced by the 
replacement if the global replacement indicator g appears after the command. If the global indica¬ 
tor does not appear, only the first occurrence of the matched string is replaced. It is an error for the 
substitution to fail on all addressed lines. Any character other than space or new-line may be used 
instead of / to delimit the RE and the replacement ; . is left at the last line on which a substitution 
occurred. See also the last paragraph before FILES below. 

An ampersand (&) appearing in the replacement is replaced by the string matching the RE on the 
current line. The special meaning of & in this context may be suppressed by preceding it by Y As 
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a more general feature, the characters \n , where n is a digit, are replaced by the text matched by 
the «-th regular subexpression of the specified RE enclosed between \( and \). When nested paren¬ 
thesized subexpressions are present, n is determined by counting occurrences of \( starting from 
the left. When the character % is the only character in the replacement, the replacement used in 
the most recent substitute command is used as the replacement in the current substitute command. 
The % loses its special meaning when it is in a replacement string of more than one character or is 
preceded by a Y 

A line may be split by substituting a new-line character into it. The new-line in the replacement 
must be escaped by preceding it by Y Such substitution cannot be done as part of a g or v com¬ 
mand list. 

(.,.)to 

This command acts just like the m command, except that a copy of the addressed lines is placed 
after address a (which may be 0);. is left at the last line of the copy. 

u 

The undo command nullifies the effect of the most recent command that modified anything in the 
buffer, namely the most recent a, c, d, g, i,j, m, r, s, t, v, G, or V command. 

(1, $ )\/RE/command list 

This command is the same as the global command g except that the command list is executed with 
. initially set to every line that does not match the RE. 

(1, $ )\/RE/ 

This command is the same as the interactive global command G except that the lines that are 
marked during the first step are those that do not match the RE. 

(l,$)w file 

The write command writes the addressed lines into the named file. If the file does not exist, it is 
created with mode 666 (readable and writable by everyone), unless your umask setting (see sh( 1)) 
dictates otherwise. The currently-remembered file name is not changed unless file is the very first 
file name mentioned since ed was invoked. If no file name is given, the currently-remembered file 
name, if any, is used (see e and / commands); . is unchanged. If the command is successful, the 
number of characters written is typed. If file is replaced by !, the rest of the line is taken to be a 
shell (s/z(l)) command whose standard input is the addressed lines. Such a shell command is not 
remembered as the current file name. 

X 

A key string is demanded from the standard input. Subsequent e, r, and w commands will encrypt 
and decrypt the text with this key by the algorithm of crypt( I). An explicitly empty key turns off 
encryption. 

($)= 

The line number of the addressed line is typed;. is unchanged by this command. 

!shell command 

The remainder of the line after the ! is sent to the UNIX System shell (sh(\ )) to be interpreted as a 
command. Within the text of that command, the unescaped character % is replaced with the 
remembered file name; if a ! appears as the first character of the shell command, it is replaced with 
the text of the previous shell command. Thus, !! will repeat the last shell command. If any expan¬ 
sion is performed, the expanded line is echoed;. is unchanged. 

( .+1 )<new-line> 

An address alone on a line causes the addressed line to be printed. A new-line alone is equivalent 
to .+lp; it is useful for stepping forward through the buffer. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and returns to its command level. 

Some size limitations: 512 characters per line, 256 characters per global command list, 64 characters per 
file name, and 128K characters in the buffer. The limit on the number of lines depends on the amount of 
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user memory: each line takes 1 word. 

When reading a file, ed discards ASCII NUL characters and all characters after the last new-line. Files (e.g., 
a.out) that contain characters not in the ASCII set (bit 8 on) cannot be edited by ed. 

If the closing delimiter of a RE or of a replacement string (e.g., /) would be the last character before a new- 
line, that delimiter may be omitted, in which case the addressed line is printed. The following pairs of com¬ 
mands are equivalent: 

s/sl/s2 s/sl/s2/p 
g/sl g/sl/p 

?sl ?sl? 

FILES 

/tmp/e# temporary; # is the process number, 

ed.hup work is saved here if the terminal is hung up. 

DIAGNOSTICS 

? for command errors. 

Ifile for an inaccessible file. 

(use the /zelp and //elp commands for detailed explanations). 

If changes have been made in the buffer since the last w command that wrote the entire buffer, ed warns the 
user if an attempt is made to destroy ed 's buffer via the e or q commands: it prints ? and allows one to con¬ 
tinue editing. A second e or q command at this point will take effect. The - command-line option inhibits 
this feature. 

SEE ALSO 

crypt(l), grep(l), sed(l), sh(l), stty(l), fspec(4), regexp(5). 

A Tutorial Introduction to the UNIX Text Editor by B. W. Kernighan. 

Advanced Editing on UNIX by B. W. Kernighan. 

CAVEATS AND BUGS 

A / command cannot be subject to a g or a v command. 

The / command and the ! escape from the e, r. and w commands cannot be used if the the editor is invoked 
from a restricted shell (see sh( 1)). 

The sequence \n in a RE does not match a new-line character. 

The l command mishandles DEL. 

Files encrypted directly with the crypt( 1) command with the null key cannot be edited. 

Characters are masked to 7 bits on input. 
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NAME 

edit - text editor (variant of ex for casual users) 

SYNOPSIS 

edit [ -r ] name ... 

DESCRIPTION 

Edit is a variant of the text editor ex recommended for new or casual users who wish to use a command ori¬ 
ented editor. The following brief introduction should help you get started with edit. A more complete basic 
introduction is provided by Edit: A tutorial. A Ex/edit command summary (version 2.0) is also very useful. 
See ex(l) for other useful documents; in particular, if you are using a CRT terminal you will want to learn 
about the display editor vi. 

BRIEF INTRODUCTION 

To edit the contents of an existing file you begin with the command “edit name” to the shell. Edit makes a 
copy of the file which you can then edit, and tells you how many lines and characters are in the file. To cre¬ 
ate a new file, just make up a name for the file and try to run edit on it; you will cause an error diagnostic, 
but don’t worry. 

Edit prompts for commands with the character which you should see after starting the editor. If you are 
editing an existing file, then you will have some lines in edit’s buffer (its name for the copy of the file you 
are editing). Most commands to edit use its “current line” if you don't tell them which line to use. Thus if 
you say print (which can be abbreviated p) and hit carriage return (as you should after all edit commands) 
this current line will be printed. If you delete (d) the current line, edit will print the new current line. 
When you start editing, edit makes the last line of the file the current line. If you delete this last line, then 
the new last line becomes the current one. In general, after a delete, the next line in the file becomes the 
current line. (Deleting the last line is a special case.) 

If you start with an empty file, or wish to add some new lines, then the append (a) command can be used. 
After you give this command (typing a carriage return after the word append) edit will read lines from your 
terminal until you give a line consisting of just a placing these lines after the current line. The last line 

you type then becomes the current line. The command insert (i) is like append but places the lines you 
give before, rather than after, the current line. 

Edit numbers the lines in the buffer, with the first line having number 1. If you give the command “1” 
then edit will type this first line. If you then give the command delete edit will delete the first line, and line 
2 will become line 1, and edit will print the current line (the new line 1) so you can see where you are. In 
general, the current line will always be the last line affected by a command. 

You can make a change to some text within the current line by using the substitute (s) command. You say 
“s/old/new/” where old is replaced by the old characters you want to get rid of and new is the new charac¬ 
ters you want to replace it with. 

The command file (f) will tell you how many lines there are in the buffer you are editing and will say 
“[Modified]” if you have changed it. After modifying a file you can put the buffer text back to replace the 
file by giving a write (w) command. You can then leave the editor by issuing a quit (q) command. If you 
run edit on a file, but don’t change it, it is not necessary (but does no harm) to write the file back. If you try 
to quit from edit after modifying the buffer without writing it out, you will be warned that there has been 
“No write since last change” and edit will await another command. If you wish not to write the buffer out 
then you can issue another quit command. The buffer is then irretrievably discarded, and you return to the 
shell. 

By using the delete and append commands, and giving line numbers to see lines in the file you can make 
any changes you desire. You should learn at least a few more things, however, if you are to use edit more 
than a few times. 

The change (c) command will change the current line to a sequence of lines you supply (as in append you 
give lines up to a line consisting of only a “.”). You can tell change to change more than one line by giv¬ 
ing the line numbers of the lines you want to change, i.e. “3,5change”. You can print lines this way too. 
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Thus “l,23p" prints the first 23 lines of the file. 

The undo (u) command will reverse the effect of the last command you gave which changed the buffer. 
Thus if give a substitute command which doesn’t do what you want, you can say undo and the old con¬ 
tents of the line will be restored. You can also undo an undo command so that you can continue to change 
your mind. Edit will give you a warning message when commands you do affect more than one line of the 
buffer. If the amount of change seems unreasonable, you should consider doing an undo and looking to see 
what happened. If you decide that the change is ok, then you can undo again to get it back. Note that com¬ 
mands such as write and quit cannot be undone. 

To look at the next line in the buffer you can just hit carriage return. To look at a number of lines hit 'D 
(control key and, while it is held down D key, then let up both) rather than carriage return. This will show 
you a half screen of lines on a CRT or 12 lines on a hardcopy terminal. You can look at the text around 
where you are by giving the command “z.”. The current line will then be the last line printed; you can get 
back to the line where you were before the “z.” command by saying The z command can also be 

given other following characters “z-” prints a screen of text (or 24 lines) ending where you are; “z+” 
prints the next screenful. If you want less than a screenful of lines do, e.g., “z.12” to get 12 lines total. 
This method of giving counts works in general; thus you can delete 5 lines starting with the current line 
with the command “delete 5”. 

To find things in the file you can use line numbers if you happen to know them; since the line numbers 
change when you insert and delete lines this is somewhat unreliable. You can search backwards and for¬ 
wards in the file for strings by giving commands of the form /text/ to search forward for text or ?text? to 
search backward for text. If a search reaches the end of the file without finding the text it wraps, end around, 
and continues to search back to the line where you are. A useful feature here is a search of the form /"text/ 
which searches for text at the beginning of a line. Similarly /text$/ searches for text at the end of a line. 
You can leave off the trailing / or ? in these commands. 

The current line has a symbolic name this is most useful in a range of lines as in “.,Sprint" which 
prints the rest of the lines in the file. To get to the last line in the file you can refer to it by its symbolic 
name “$”. Thus the command “$ delete” or “$d” deletes the last line in the file, no matter which line 
was the current line before. Arithmetic with line references is also possible. Thus the line “$-5” is the 
fifth before the last, and “.+20” is 20 lines after the present. 

You can find out which line you are at by doing This is useful if you wish to move or copy a section 

of text within a file or between files. Find out the first and last line numbers you wish to copy or move (say 
10 to 20). For a move you can then say “10,20delete a” which deletes these lines from the file and places 
them in a buffer named a. Edit has 26 such buffers named a through z. You can later get these lines back by 
doing ‘ ‘put a’ ’ to put the contents of buffer a after the current line. If you want to move or copy these lines 
between files you can give an edit (e) command after copying the lines, following it with the name of the 
other file you wish to edit, i.e. “edit chapter2”. By changing delete to yank above you can get a pattern for 
copying lines. If the text you wish to move or copy is all within one file then you can just say “10,20move 
$” for example. It is not necessary to use named buffers in this case (but you can if you wish). 

SEE ALSO 

ex (1), vi (1), ‘Edit: A tutorial’, by Ricki Blau and James Joyce 

AUTHOR 

William Joy 

BUGS 

See ex(l). 

SUPPORT 

COMPONENT NAME: edit 
AUTHORIZER: HOLMDEL 
STATUS: LOCAL 
SUPPLIER: Dept 45223 

USER INTERFACE: Program Counseling Sendee 
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SUPPORT LEVEL: Provisional 

COMMENTS: Version 2.1* is for the PDF 11/70 and version 
3.6 is for the VAX. 
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NAME 

efl - Extended Fortran Language 

SYNOPSIS 

efl [ options ] [ files ] 

DESCRIPTION 

Efl compiles a program written in the EFL language into clean Fortran on the standard output. Efl provides 
the C-like control constructs of ratfor( 1): 

statement grouping with braces. 

decision-making: 

if, if-else, and select-case (also known as switch-case); 
while, for, Fortran do, repeat, and repeat... until loops; 
multi-level break and next. 

EFL has C-like data structures, e.g.: 

struct 

{ 

integer flags(3) 
character(8) name 
long real coords(2) 

} table) 100) 

The language offers generic functions, assignment operators (+=, &=, etc.), and sequentially evaluated logi¬ 
cal operators (&& and I I). There is a uniform input/output syntax: 

write(6,x,y:f(7,2), do i= 1,10 { a(i,j),z.b(i) }) 

EFL also provides some syntactic “sugar”: 

free-form input: 

multiple statements per line; automatic continuation; statement label names (not just 
numbers). 

comments: 

# this is a comment. 

translation of relational and logical operators: 

>, >=, &, etc., become .GT., .GE„ .AND., etc. 

return expression to caller from function: 
return ( expression ) 

defines: 

define name replacement 

includes: 

include file 

Efl understands several option arguments: -w suppresses warning messages, —# suppresses comments in the 
generated program, and the default option -C causes comments to be included in the generated program. 

An argument with an embedded = (equal sign) sets an EFL option as if it had appeared in an option state¬ 
ment at the start of the program. Many options are described in the reference manual. A set of defaults for 
a particular target machine may be selected by one of the choices: system=unix, system=gcos, or 
system=cray. The default setting of the system option is the same as the machine the compiler is running 
on. Other specific options determine the style of input/output, error handling, continuation conventions, the 
number of characters packed per word, and default formats. 

Efl is best used with/77(l). 
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SEE ALSO 

cc(l), f77(l), ratfor(l). 

The Programming Language EFL by S.I. Feldman. 
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NAME 

enable, disable - enable/disable LP printers 

SYNOPSIS 

enable printers 

disable [ -c ] [ -r[ reason ] ] printers 

DESCRIPTION 

Enable activates the named printers, enabling them to print requests taken by lp( 1). Use lpstat{ 1) to find 
the status of printers. 

Disable deactivates the named printers, disabling them from printing requests taken by lp( I). By default, 
any requests that are currently printing on the designated printers will be reprinted in their entirety either on 
the same printer or on another member of the same class. Use lpstat( I) to find the status of printers. 
Options useful with disable are: 

-c Cancel any requests that are currently printing on any of the designated printers. 

-r [reason] Associates a reason with the deactivation of the printers. This reason applies to all printers 
mentioned up to the next -r option. If the -r option is not present or the -r option is given 
without a reason, then a default reason will be used. Reason is reported by lpstat{ 1). 

FILES 

/usr/spool/lp/* 

SEE ALSO 

lp(l), lpstat(l). 
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NAME 

env - set environment for command execution 
SYNOPSIS 

env [-] [ name=value ] ... [ command args ] 

DESCRIPTION 

Env obtains the current environment, modifies it according to its arguments, then executes the command 
with the modified environment. Arguments of the form name=value are merged into the inherited environ¬ 
ment before the command is executed. The - flag causes the inherited environment to be ignored com¬ 
pletely, so that the command is executed with exactly the environment specified by the arguments. 

If no command is specified, the resulting environment is printed, one name-value pair per line. 

SEE ALSO 

sh(l), exec(2), profile(4), environ(5). 
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NAME 

eqn, neqn, checkeq - format mathematical text for nroff or troff 
SYNOPSIS 

eqn [ -dxy ] [ -pn ] [ -sn ] [ -fn ] [ files ] 
neqn [ -dxy ] [ -pn ] [ -sn ] [ -fn | [ files ] 
checkeq [ files ] 


DESCRIPTION 

Eqn is a troff (1) preprocessor for typesetting mathematical text on a phototypesetter, while neqn is used for 
the same purpose with nroff on typewriter-like terminals. Usage is almost always: 

eqn files I troff 
neqn files I nroff 

or equivalent. 

If no files are specified (or if - is specified as the last argument), these programs read the standard input. A 
line beginning with ,EQ marks the start of an equation; the end of an equation is marked by a line beginning 
with ,EN. Neither of these lines is altered, so they may be defined in macro packages to get centering, num¬ 
bering, etc. It is also possible to designate two characters as delimiters', subsequent text between delimiters 
is then treated as eqn input. Delimiters may be set to characters x and y with the command-line argument 
-dxy or (more commonly) with delim xy between ,EQ and ,EN. The left and right delimiters may be the 
same character; the dollar sign is often used as such a delimiter. Delimiters are turned off by delim off. All 
text that is neither between delimiters nor between ,EQ and ,EN is passed through untouched. 

The program checkeq reports missing or unbalanced delimiters and .EQ/.EN pairs. 

Tokens within eqn are separated by spaces, tabs, new-lines, braces, double quotes, tildes, and circumflexes. 
Braces { } are used for grouping; generally speaking, anywhere a single character such as x could appear, a 
complicated construction enclosed in braces may be used instead. Tilde (~) represents a full space in the 
output, circumflex ("'■) half as much. 


Subscripts and superscripts are produced with the keywords sub and sup. Thus x sub j makes Xj, 
a sub k sup 2 produces a\, while e x +y is made with e sup {x sup 2 + y sup 2}. Fractions are made with 


over: a over b yields —; sqrt makes square roots: 1 over sqrt {ax sup 2+bx+c} results in —- 
b 


1 


' + bx + c 


The keywords from and to introduce lower and upper limits: lim x, is made with 

o 

lim from {n -> inf j sum from 0 to n x sub i. Left and right brackets, braces, etc., of the right height are 

.,2 

made with left and right: left [ x sup 2 + y sup 2 over alpha right ] ~=~ 1 produces 


x 2 + ^- 

a 


= 1 . 


Legal characters after left and right are braces, brackets, bars, c and f for ceiling and floor, and " " for noth¬ 
ing at all (useful for a right-side-only bracket). A left thing need not have a matching right thing. 


Vertical piles of things are made with pile, lpile, cpile, and rpile: pile {a above b above cj produces b. 

c 

Piles may have arbitrary numbers of elements; lpile left-justifies, pile and cpile center (but with different 
vertical spacing), and rpile right justifies. Matrices are made with matrix: matrix { Icol { x sub i above y 

x, 1 

sub 2 j ccol { 1 above 2 j } produces n . In addition, there is rcol for a right-justified column. 

Diacritical marks are made with dot, dotdot, hat, tilde, bar, vec, dyad, and under: x dot = f(t) bar is 
x =f(t), y dotdot bar ~=~n under is y = n, and x vec ~=~y dyad is x = *y. 
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Point sizes and fonts can be changed with size n or size ±n, roman, italic, bold, and font n. Point sizes 
and fonts can be changed globally in a document by gsize n and gfont n , or by the command-line argu¬ 
ments -s n and -in. 

Normally, subscripts and superscripts are reduced by 3 points from the previous size; this may be changed 
by the command-line argument -p«. 

Successive display arguments can be lined up. Place mark before the desired lineup point in the first equa¬ 
tion; place lineup at the place that is to line up vertically in subsequent equations. 

Shorthands may be defined or existing keywords redefined with define: 

define thing % replacement % 

defines a new token called thing that will be replaced by replacement whenever it appears thereafter. The 
% may be any character that does not occur in replacement. 

Keywords such as sum ( int ( f), inf (oo), and shorthands such as >= (>), != (V), and -> (—> ) are 
recognized. Greek letters are spelled out in the desired case, as in alpha (a), or GAMMA (T). Mathemati¬ 
cal words such as sin, cos, and log are made Roman automatically. Troff(\) four-character escapes such as 
\(dd ($) and \(bs (\) may be used anywhere. Strings enclosed in double quotes ("...") are passed through 
untouched; this permits keywords to be entered as text, and can be used to communicate with troff(l) when 
all else fails. Full details are given in the manual cited below. 

SEE ALSO 

Typesetting Mathematics-User’s Guide by B. W. Kemighan and L. L. Cherry. 
cw(l), mm(l), mmt(l), nroff(l), tbl(l), troff(l), eqnchar(5), mm(5), mv(5). 

BUGS 

To embolden digits, parentheses, etc., it is necessary to quote them, as in bold "12.3". 

See also BUGS under troff(l). 
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NAME 

ex - text editor 
SYNOPSIS 

ex [ - ] [ -v ] [ -t tag ] [ -r ] [ +command ] [ -1 ] name ... 

DESCRIPTION 

Ex is the root of a family of editors: edit, ex and vi. Ex is a superset of ed, with the most notable extension 
being a display editing facility. Display based editing is the focus of vi. 

If you have not used ed, or are a casual user, you will find that the editor edit is convenient for you. It 
avoids some of the complexities of ex used mostly by systems programmers and persons very familiar with 
ed. 

If you have a CRT terminal, you may wish to use a display based editor; in this case see v/(l), which is a 
command which focuses on the display editing portion of ex. 

DOCUMENTATION 

The document Edit: A tutorial provides a comprehensive introduction to edit assuming no previous knowl¬ 
edge of computers or the UNIX System. 

The Ex Reference Manual - Version 3.1 is a comprehensive and complete manual for the command mode 
features of ex, but you cannot learn to use the editor by reading it. For an introduction to more advanced 
forms of editing using the command mode of ex see the editing documents written by Brian Kernighan for 
the editor ed; the material in the introductory and advanced documents works also with ex. 

An Introduction to Display Editing with Vi introduces the display editor vi and provides reference material 
on vi. The Vi Quick Reference card summarizes the commands of vi in a useful, functional way, and is use¬ 
ful with the Introduction. 

FOR ED USERS 

If you have used ed you will find that ex has a number of new features useful on CRT terminals. Intelligent 
terminals and high speed terminals are very pleasant to use with vi. Generally, the editor uses far more of 
the capabilities of terminals than ed does, and uses the terminal capability data base termcapi 5) and the 
type of the terminal you are using from the variable TERM in the environment to determine how to drive 
your terminal efficiently. The editor makes use of features such as insert and delete character and line in its 
visual command (which can be abbreviated vi) and which is the central mode of editing when using vi{ 1). 
There is also an interline editing open (o) command which works on all terminals. 

Ex contains a number of new features for easily viewing the text of the file. The z command gives easy 
access to windows of text. Hitting 'D causes the editor to scroll a half-window of text and is more useful 
for quickly stepping through a file than just hitting return. Of course, the screen oriented visual mode gives 
constant access to editing context. 

Ex gives you more help when you make mistakes. The undo (u) command allows you to reverse any sin¬ 
gle change which goes astray. Ex gives you a lot of feedback, normally printing changed lines, and indi¬ 
cates when more than a few lines are affected by a command so that it is easy to detect when a command 
has affected more lines than it should have. 

The editor also normally prevents overwriting existing files unless you edited them so that you don’t acci¬ 
dentally clobber with a write a file other than the one you are editing. If the system (or editor) crashes, or 
you accidentally hang up the phone, you can use the editor recover command to retrieve your work. This 
will get you back to within a few lines of where you left off. 

Ex has several features for dealing with more than one file at a time. You can give it a list of files on the 
command line and use the next (n) command to deal with each in turn. The next command can also be 
given a list of file names, or a pattern as used by the shell to specify a new set of files to be dealt with. In 
general, filenames in the editor may be formed with full shell metasyntax. The metacharacter ‘%’ is also 
available in forming filenames and is replaced by the name of the current file. 
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For moving text between files and within a file the editor has a group of buffers, named a through z. You 
can place text in these named buffers and carry it over when you edit another file. 

There is a command & in ex which repeats the last substitute command. In addition there is a confirmed 
substitute command. You give a range of substitutions to be done and the editor interactively asks whether 
each substitution is desired. 


You can use the substitute command in ex to systematically convert the case of letters between upper and 
lower case. It is possible to ignore case of letters in searches and substitutions. Ex also allows regular 
expressions which match words to be constructed. This is convenient, for example, in searching for the 
word “edit” if your document also contains the word “editor.” 

Ex has a set of options which you can set to tailor it to your liking. One option which is very useful is the 
autoindent option which allows the editor to automatically supply leading white space to align text. You 
can then use the 'D key as a backtab and space and tab forward to align new code easily. 

Miscellaneous new useful features include an intelligent join (j) command which supplies white space 
between joined lines automatically, commands < and > which shift groups of lines, and the ability to filter 
portions of the buffer through commands such as sort. 


FILES 

/usr/lib/ex?.?strings 
/usr/lib/ex?. ?recover 
/usr/lib/ex?. ?preserve 
/etc/termcap 
7.exrc 

/tmp/E xnnnnn 
/tmp/R xnnnnn 
/usr/preserve 


error messages 

recover command 

preserve command 

describes capabilities of terminals 

editor startup file 

editor temporary 

named buffer temporary 

preservation directory 


SEE ALSO 

awk(l), ed(l), grep(l), sed(l), edit(l), grep(l), termcap(5), vi(l) 


AUTHOR 

William Joy 

Mark Horton added macros to visual mode and is maintaining version 3 


BUGS 

The undo command causes all marks to be lost on lines changed and then restored if the marked lines were 
changed. 

Undo never clears the buffer modified condition. 


The z command prints a number of logical rather than physical lines. More than a screen full of output may 
result if long lines are present. 

File input/output errors don’t print a name if the command line option is used. 

There is no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buffers and not used before exiting the editor. 

Null characters are discarded in input files, and cannot appear in resultant files. 

SUPPORT 

COMPONENT NAME: ex 
AUTHORIZED HOLMDEL 
STATUS: LOCAL 
SUPPLIER: Dept 45223 

USER INTERFACE: Program Counseling Sendee 
SUPPORT LEVEL: Provisional 

COMMENTS: Version 2.1* is for the PDP 11/70 and version 
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5.* is for the VAX. 
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NAME 

expr - evaluate arguments as an expression 

SYNOPSIS 

expr arguments 

DESCRIPTION 

The arguments are taken as an expression. After evaluation, the result is written on the standard output. 
Terms of the expression must be separated by blanks. Characters special to the shell must be escaped. 
Note that 0 is returned to indicate a zero value, rather than the null string. Strings containing blanks or 
other special characters should be quoted. Integer-valued arguments may be preceded by a unary minus 
sign. Internally, integers are treated as 32-bit, 2’s complement numbers. 

The operators and keywords are listed below. Characters that need to be escaped are preceded by Y The 
list is in order of increasing precedence, with equal precedence operators grouped within { } symbols. 

expr \ I expr 

returns the first expr if it is neither null nor 0, otherwise returns the second expr. 
expr \& expr 

returns the first expr if neither expr is null or 0, otherwise returns 0. 
expr { =, \>, \>=, \<, \<=, != } expr 

returns the result of an integer comparison if both arguments are integers, otherwise returns the 
result of a lexical comparison. 

expr { +, - } expr 

addition or subtraction of integer-valued arguments. 
expr { \*, /, % } expr 

multiplication, division, or remainder of the integer-valued arguments. 
expr: expr 

The matching operator : compares the first argument with the second argument which must be a 
regular expression; regular expression syntax is the same as that of ed( 1), except that all patterns 
are “anchored” (i.e., begin with ') and, therefore, ' is not a special character, in that context. Nor¬ 
mally, the matching operator returns the number of characters matched (0 on failure). Alterna¬ 
tively, the \(.. .\) pattern symbols can be used to return a portion of the first argument. 

EXAMPLES 

1. a='expr $a + l v 

adds 1 to the shell variable a. 

2. # 'For $a equal to either "/usr/abc/file" or just "file"' 
expr $a : '.*A(.*\)' \l $a 

returns the last segment of a path name (i.e., file). Watch out for / alone as an argument: 
expr will take it as the division operator (see BUGS below). 

3. # A better representation of example 2. 
expr //$a : '.*A(.*\)' 

The addition of the // characters eliminates any ambiguity about the division operator and 
simplifies the whole expression. 

4. expr $VAR : 

returns the number of characters in $VAR. 

SEE ALSO 

ed(l), sh( 1). 

EXIT CODE 

As a side effect of expression evaluation, expr returns the following exit values: 
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0 if the expression is neither null nor 0 

1 if the expression is null or 0 

2 for invalid expressions. 

DIAGNOSTICS 

syntax error for operator/operand errors 

non-numeric argument if arithmetic is attempted on such a string 

BUGS 

After argument processing by the shell, expr cannot tell the difference between an operator and an operand 
except by the value. If $a is an =, the command: 

expr $a = 

looks like: 

expr = = = 

as the arguments are passed to expr (and they will all be taken as the = operator). The following works: 
expr X$a = X= 
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NAME 

f77 - Fortran 77 compiler 

SYNOPSIS 

f77 [ options ] files 

DESCRIPTION 

F77 is the UNIX Fortran 77 compiler; it accepts several types of file arguments: 

Arguments whose names end with .f are taken to be Fortran 77 source programs; they are com¬ 
piled and each object program is left in the current directory in a file whose name is that of the 
source, with .o substituted for .f. 


Arguments whose names end with .r or .e are taken to be RATFOR or EFL source programs, 
respectively; these are first transformed by the appropriate preprocessor, then compiled by f77, 
producing .o files. 

In the same way, arguments whose names end with .c or .s are taken to be C or assembly source 
programs and are compiled or assembled, producing .o files. 

The following options have the same meaning as in cc(l) (see ld( 1) for link editor options): 


-c Suppress link editing and produce .o files for each source file. 

-p Prepare object files for profiling (see profi I )). 

-O Invoke an object-code optimizer. 

-S Compile the named programs and leave the assembler-language output in corresponding 

files whose names are suffixed with .s. (No .o files are created.) 

-o output Name the final output file output, instead of a.out. 

-f In systems without floating-point hardware, use a version of f77 that handles floating-point 

constants and links the object program with the floating-point interpreter. 

-g Generate additional information needed for the use of sdb{ 1) (VAX-11/780 only). 


The following options are peculiar to/77: 


-onetrip 

-1 

-66 

-C 

-I [24s] 


-U 

-u 

-w 

-F 

-m 

-E 

-R 


Compile DO loops that are performed at least once if reached. (Fortran 77 DO loops are not 
performed at all if the upper limit is smaller than the lower limit.) 

Same as -onetrip. 

Suppress extensions which enhance Fortran 66 compatibility. 

Generate code for run-time subscript range-checking. 

Change the default size of integer variables (only valid on machines where the “normal” 
integer size is not equal to the size of a single precision real). -12 causes all integers to be 
2-byte quantities, -14 (default) causes all integers to be 4-byte quantities, and -Is changes 
the default size of subscript expressions (only) from the size of an integer to 2 bytes. 

Do not "fold" cases. F77 is normally a no-case language (i.e. a is equal to A). The -U 
option causes/77 to treat upper and lower cases to be separate. 

Make the default type of a variable undefined, rather than using the default Fortran rules. 
Suppress all warning messages. If the option is -w66, only Fortran 66 compatibility warn¬ 
ings are suppressed. 

Apply EFL and RATFOR preprocessor to relevant files, put the result in files whose names 
have their suffix changed to .of. (No .o files are created.) 

Apply the M4 preprocessor to each EFL or RATFOR source file before transforming with the 
ratfor(l) or efl( 1) processors. 

The remaining characters in the argument are used as an EFL flag argument whenever pro¬ 
cessing a .e file. 

The remaining characters in the argument are used as a RATFOR flag argument whenever 
processing a .r file. 


Other arguments are taken to be either link-editor option arguments or/77-compilable object programs 
(typically produced by an earlier run), or libraries of/77-compilable routines. These programs, together 
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with the results of any compilations specified, are linked (in the order given) to produce an executable pro¬ 
gram with the default name a.out. 

FILES 

file.ffresc] 
file.o 
a.out 

./fort [p/d].? 

/usr/lib/f77passl 
/lib/cl 
/lib/c2 

/usr/lib/libF77.a 
/usr/lib/libI77.a 
/lib/libc.a 

SEE ALSO 

A Portable Fortran 77 Compiler by S. I. Feldman and P. J. Weinberger. 
asa(l), cc(l), efl(l), fsplit(l), ld(l), m4(l), prof(l), ratfor(l), sdb(l). 

DIAGNOSTICS 

The diagnostics produced by f77 itself are intended to be self-explanatory. Occasional messages may be 
produced by the link editor ld( 1). 


input file 
object file 
linked output 
temporary 
compiler 
pass 2 

optional optimizer 
intrinsic function library 
Fortran I/O library 

C library; see Section 3 of this Manual. 
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NAME 

factor - factor a number 

SYNOPSIS 

factor [ number ] 

DESCRIPTION 

When factor is invoked without an argument, it waits for a number to be typed in. If you type in a positive 
number less than 2 (about 7.2x10 ) it will factor the number and print its prime factors; each one is 
printed the proper number of times. Then it waits for another number. It exits if it encounters a zero or any 
non-numeric character. 

If factor is invoked with an argument, it factors the number as above and then exits. 

Maximum time to factor is proportional to and occurs when n is prime or the square of a prime. It takes 
1 minute to factor a prime near 10 14 on a PDP-11. 

DIAGNOSTICS 

“Ouch” for input out of range or for garbage input. 
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NAME 

fget, fget.demon - retrieve files from the HONEYWELL 6000 
SYNOPSIS 

fget [ options ] [ files ] 

/usr/lib/fget.demon time 

DESCRIPTION 

Fget arranges to have one or more GCOS files sent to the UNIX System. GCOS identification must appear in 
the UNIX System password file (see passwd(A)), or be supplied by the -i option. Normally, the files 
retrieved will appear in the UNIX System user’s current directory under the GCOS file name. Fget.demon is 
the daemon that does the actual retrieval. 

The GCOS catalog from which the files are obtained depends on the form of the file name argument. If the 
file name has only embedded slashes, then it is assumed to be a full GCOS path name and that file is 
retrieved. If the file name has no embedded slashes or begins with a slash, then the GCOS catalog from 
which the file is retrieved is the same as the UNIX System login name of the person who issues the com¬ 
mand. If, however, a user has a different name in the third field of the GCOS “ident card image” (which 
image is extracted from the UNIX System password file-see passwd( 4)), this name is taken as the GCOS 
catalog name. Whatever GCOS catalog is finally used, the files must either have general read permission or 
the user must have arranged that the user ID network has read permission on that catalog (see fsend (\C)). 
This can be accomplished with the GCOS command: 

filsys me <user ID>,(r)/network/ 

The UNIX System file into which the retrieved GCOS file will ultimately be written is initialized with one 
line containing the complete GCOS file name. If the file contains the initial line for an extended period, it 
means that GCOS is down or something has gone horribly wrong and you should try again. 

The following options, each as a separate argument may appear in any order but must precede all file argu¬ 
ments. 

-a Retrieve files as ASCII (default). 

-b Retrieve files as binary. 

-d dir Use dir as the UNIX System directory into which retrieved files are written. 

-ffile Use file as the UNIX System filename for the retrieved file. 

-i job,bin 

Supply the GCOS “ident card" image as the parameter -i job,bin where job is the GCOS job num¬ 
ber and bin the GCOS bin number or any comment to the GCOS operators. 

-m When the request has been forwarded to GCOS, report by mail( 1) the so-called snumb of the 
receiving job; mail is sent by the UNIX System dpd( 1C) daemon; there is no guarantee that the 
GCOS job ran or that the UNIX System retrieved the output. This is the default option. 

-n Do not report the forwarding of the request by mail( 1). 

-o Print the on-line GCOS accounting output. 

-t Toss out the on-line GCOS accounting output. This is the default option. 

-s n Submit job to GCOS with service grade n (n = 1, 2, 3, 4). Default is -si. 

-u userid 

Use userid as the GCOS catalog name for all files. 

The GCOS job to send the requested files to the UNIX System is sent by the dpd( 1C) daemon. Receiving 
these files is then done by a corresponding retrieval daemon, fget.demon, which stays alive for a minimum 
of time seconds, (default 360), or until it has successfully retrieved one or more files. The file glock in the 
spooling directory /usr/spool/dpd is used to prevent two daemons from becoming active simultaneously. 
After the program has successfully set the lock, it forks and the main path exits, thus spawning the daemon. 
CRTS is interrogated for any output for the daemon’s station-id. If non e, fget.demon will wait up to time 
seconds, interrogating GRTS every minute or so to see if any output has arrived. All problems and success¬ 
ful transactions are recorded in the errors file in the spooling directory. 
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To restart fget.demon (in the case of hardware or software malfunction), it is necessary to first kill the old 
fget.demon (if still alive), and remove the lock file (if present), before initiating fget.demon. This should be 
done automatically by /etc/rc when the system is brought up, in case there are any files waiting to come 
over. 

EXAMPLES 

The command: 

fget -ugcosme -t -n -d/usr/me/test filel file2 

will retrieve the GCOS files gcosme/filel and gcosme/file2, as the UNIX System files /usr/me/test/filel and 
/usr/me/test/file2, respectively, but will not generate any mail or GCOS accounting output as a result of the 
transaction. 

FILES 

/etc/passwd 
/usr/lib/dpd 
/usr/spool/dpd/* 

/dev/dn? 

/dev/du? 

/dev/vpb? 

/dev/vpm? 

SEE ALSO 

dpd(lC), dpr(lC), fsend(lC), passwd(4). 


user’s identification and GCOS ident card, 
sending daemon, 
spool area. 

ACU device. 

DATA-PHONE data set. 

Bottom VPM device to interface to KMCl 1-B. 
Top VPM device to interface to KMCl 1-B. 


Page 2 



FILE(l) 


FILE(l) 


NAME 

file - determine file type 
SYNOPSIS 

file [ -c ] [ -f ffile ] [ -m mfile ] arg ... 

DESCRIPTION 

File performs a series of tests on each argument in an attempt to classify it. If an argument appears to be 
ASCII, file examines the first 512 bytes and tries to guess its language. If an argument is an executable 
a.out, file will print the version stamp, provided it is greater than 0 (see ld( 1)). 

If the -f option is given, the next argument is taken to be a file containing the names of the files to be exam¬ 
ined. 

File uses the file /etc/magic to identify files that have some sort of magic number , that is, any file contain¬ 
ing a numeric or string constant that indicates its type. Commentary at the beginning of /etc/magic explains 
its format. 

The -m option instructs file to use an alternate magic file. 

The -c flag causes file to check the magic file for format errors. This validation is not normally carried out 
for reasons of efficiency. No file typing is done under -c. 
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NAME 

find - find files 

SYNOPSIS 

find path-name-list expression 

DESCRIPTION 

Find recursively descends the directory hierarchy for each path name in the path-name-list (i.e., one or 
more path names) seeking files that match a boolean expression written in the primaries given below. In 
the descriptions, the argument n is used as a decimal integer where +n means more than n , —n means less 
than n and n means exactly n. 

-name file True if file matches the current file name. Normal shell argument syntax may be used 

if escaped (watch out for [, ? and *). 

-perm onum True if the file permission flags exactly match the octal number oiunii (see chmod{ 1)). 

If onum is prefixed by a minus sign, more flag bits (017777, see stat{ 2)) become 
significant and the flags are compared: 

(flags&onum)==onum 

-type c True if the type of the file is c, where c is b, c, d, p, or f for block special file, character 

special file, directory, fifo (a.k.a named pipe), or plain file. 

-links n True if the file has n links. 

-user uname True if the file belongs to the user uname. If uname is numeric and does not appear as 

a login name in the /etc/passwd file, it is taken as a user ID. 

-group gname True if the file belongs to the group gname. If gname is numeric and does not appear 
in the /etc/group file, it is taken as a group ID. 

-size n True if the file is n blocks long (512 bytes per block). 

-atime n True if the file has been accessed in n days. 

-mtime n True if the file has been modified in n days. 

-dime n True if the file has been changed in n days. 

-exec cmd True if the executed and returns a zero value as exit status. The end of and must be 

punctuated by an escaped semicolon. A command argument {} is replaced by the cur¬ 
rent path name. 

-ok and Like -exec except that the generated command line is printed with a question mark 

first, and is executed only if the user responds by typing y. 

-print Always true; causes the current path name to be printed. 

-cpio device Write the current file on device in cpio (4) format (5120 byte records). 

-newer file True if the current file has been modified more recently than the argument file. 

( expression ) True if the parenthesized expression is true (parentheses are special to the shell and 

must be escaped). 

The primaries may be combined using the following operators (in order of decreasing precedence): 

1) The negation of a primary (! is the unary not operator). 

2) Concatenation of primaries (the and operation is implied by the juxtaposition of two primaries). 

3) Alternation of primaries (-o is the or operator). 

EXAMPLE 

To remove all files named a.out or *.o that have not been accessed for a week: 
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find / \( -name a.out -o -name '*.o' \) -atime +7 -exec rm {} \; 

FILES 

/etc/passwd, /etc/group 

SEE ALSO 

cpio(l), sh(l), test(l), stat(2), cpio(4), fs(4). 
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NAME 

fsend - send files to the HONEYWELL 6000 
SYNOPSIS 

fsend [ options ] [ files ] 

DESCRIPTION 

Fsend arranges to have one or more UNIX System files sent to HONEYWELL GCOS. GCOS identification 
must appear in the UNIX System password file (see passwd(A)), or be supplied by the -i option. If no 
names appear, the standard input is sent; thus fsend may be used as a filter. 

Normally, the catalog on the HONEYWELL file system in which the new file will appear is the same as the 
UNIX System login name of the person who issues the command. If, however, a user has a different name 
in the third field of the GCOS “ident card image” (which image is extracted from the UNIX System pass¬ 
word file; see passwd{ 4)), this name is taken as the GCOS catalog name. Whatever GCOS catalog is finally 
used, the user must have arranged that the user ID ‘ ‘network'' has create permission on that catalog, or read 
and write permission on the individual files. The latter is more painful but preferred if access to other files 
in the catalog is to be fully controlled. This can be accomplished with the GCOS commands: 

filsys me <user ID>,c/network/,m/ <user ID>/ 
or 

filsys cf <file>,w/network/,b/<initial-size>,unlimited/ 

The name of the GCOS file is ordinarily the same as the name of the UNIX System file. When the standard 
input is sent, the GCOS file is normally taken to be pipe.end. 

The following options, each as a separate argument, may appear in any order but must precede all file name 
arguments. 

-a Send succeeding files as ASCII (default). If the last character of the file is not a new-line, one is 
added. All other characters are preserved. 

-b Send succeeding files as binary. Each UNIX System byte is right justified in a GCOS byte and the 
bytes packed into 120-byte logical records (30 GCOS words). The last record is padded out with 
NULs. 

-c Make copies of the files to be sent before returning to the user. 

-r Remove the files after sending them. 

-f file Use file as the GCOS file name for the file being sent. 

-i job, bin 

Supply the GCOS “ident card" image as the parameter -i job,bin where job is the GCOS job num¬ 
ber and bin the GCOS bin number or any comment to the GCOS operators. 

-m When transmission is complete, report by mail( 1) the so-called snumb of the receiving GCOS job. 
The mail is sent by the UNIX System daemon; there is no guarantee that the GCOS job ran success¬ 
fully. This is the default option. 

-n Do not report the completion of transmission by mail (1). 

-o Print the on-line GCOS accounting output. 

-t Toss out the on-line GCOS accounting output. This is the default option. 

—s n Submit job to GCOS with service grade n (n = 1, 2, 3, 4). Default is -si. 

-u userid 

Use userid as the GCOS catalog name for all files. 

-x Send succeeding files to be archived by the GCOS archive command. 

EXAMPLE 

The command: 

fsend -t -uunixsup -b -fgfile ufile 

will send the binary UNIX System file ufile to become the GCOS file unixsup/gfile, and will not produce 
any on-line GCOS accounting output. 
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FILES 

/etc/passwd user’s identification and GCOS ident card, 

/usr/lib/dpd sending daemon. 

/usr/spool/dpd/* spool area. 

SEE ALSO 

dpd(lC), dpr(lC), fget(lC), gcat(lC), mail(l). 
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NAME 

fsplit - split f77, ratfor, or efl files 

SYNOPSIS 

fsplit options files 

DESCRIPTION 

Fsplit splits the named filets) into separate files, with one procedure per file. A procedure includes block- 
data, function, main, program, and subroutine program segments. Procedure X is put in file X f, X.r, or X.e 
depending on the language option chosen, with the following exceptions: main is put in the file MAIN. [efr] 
and unnamed blockdata segments in the files blockdataN. [efr] where A is a unique integer value for each 
file. 

The 

-f 

-r 

-e 

-s 

SEE ALSO 

csplit(l), efl(l), f77(l), ratfor(l), split(l). 


following options pertain: 

(default) Input files are/77. 

Input files are ratfor. 

Input files are Efl. 

Strip f77 input lines to 72 or fewer characters with trailing blanks removed. 
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NAME 

gcat - send phototypesetter output to the HONEYWELL 6000 
SYNOPSIS 

gcat [ options ] [ files ] 

DESCRIPTION 

Gcat arranges to have troff(l) output sent to the phototypesetter or debugging devices (STARE or line 
printer) attached to the HONEYWELL system. GCOS identification must appear in the UNIX System pass¬ 
word file (see passwd{ 4)), or be supplied by the -i option. If no file name appears, the standard input is 
sent; thus gcat may be used as an output pipe for troff{ 1). 

The option -g (for GCOS) must be used with the troff(l) command to make things work properly. This 
command string sends output to the GCOS phototypesetter: 

troff -g file I gcat 

The following options, each as a separate argument, and in any combination (multiple outputs are permit¬ 
ted), may be given after gcat: 

-ph Send output to the phototypesetter. This is a default option. 

-st Send output to STARE for fast tum-around. 

-tx Send output as text to the line printer (useful for checking spelling, hyphenation, pagination, etc.), 

-du Send output to the line printer, dummied up to make the format correct. Because many characters 

are dropped, the output is unreadable, but useful for seeing the shape (margins, etc.) of the docu¬ 
ment. 

-c Make a copy of the file to be sent before returning to the user. 

-r Remove the file after sending it. 

-f file \Jse file as a dummy file name to report back in the mail. (This is useful for distinguishing multi¬ 

ple runs, especially when gcat is being used as a filter). 

-i job,bin 

Supply the GCOS “ident card” image as the parameter -ijob,bin where job is the GCOS job num¬ 
ber and bin the GCOS bin number or any comment to the GCOS operators. 

-m When transmission is complete, report by mail{ 1) the so-called snumb of the receiving GCOS job. 
The mail is sent by the UNIX daemon; there is no guarantee that the GCOS job ran successfully. 
This is a default option. 

-n Do not report the completion of transmission by mail (1). 

-o Print the on-line GCOS accounting output. 

-t Toss out the on-line GCOS accounting output. This is a default option. 

-s n Submit job to GCOS with service grade a (n = 1, 2, 3, 4). Default is -si. 

If none of the output options are specified, phototypesetter output (-ph) is assumed by default. 

EXAMPLE 

The command: 

troff -g myfile I gcat -st -iml234,m567,myname -fmyfile 

will send the output of troff( I) to STARE, with the GCOS “ident card” specifying 
“M1234,M567,MYNAME”, and will report back that myfile has been sent. 

FILES 

/etc/passwd user’s identification and GCOS ident card. 

/usr/lib/dpd sending daemon. 

/usr/spool/dpd/* spool area. 

SEE ALSO 

dpd(lC), dpr(lC), fget(lC), fsend(lC), troff(l). 
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NAME 

gcosmail - send mail to HIS user 

SYNOPSIS 

gcosmail [ option ... ] [ HlSuserid ... ] 

DESCRIPTION 

Gcosmail takes the standard input up to an end of file and sends it as mail to the named users on the 
HONEYWELL 6000 system, using the HIS mail command. The following options are recognized by 
gcosmail: 

-f file \Jse file as a dummy file name to report back in the mail. (This is useful for distinguishing multi¬ 

ple runs). 

-\job,bin 

Supply the GCOS “ident card” image as the parameter -ijob,bin where job is the GCOS job num¬ 
ber and bin the GCOS bin number or any comment to the GCOS operators. 

-m When transmission is complete, report by mail{ 1) the so-called snumb of the receiving GCOS job. 
The mail is sent by the UNIX System daemon; there is no guarantee that the GCOS job ran success¬ 
fully. This is a default option. 

-n Do not report the completion of transmission by mail (1). 

-o Print the on-line GCOS accounting output. 

-t Toss out the on-line GCOS accounting output. This is a default option. 

-s n Submit job to GCOS with service grade n (n = 1, 2, 3, 4). Default is -si. 

FILES 

/etc/passwd user’s identification and GCOS ident card. 

/usr/lib/dpd sending daemon. 

/usr/spool/dpd/* spool area. 

SEE ALSO 

dpd(lC), dpr(lC), fsend(lC). 
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NAME 

hpd, erase, hardcopy, tekset, td - graphical device routines and filters 
SYNOPSIS 

hpd [-options] [GPS file ...] 

erase 

hardcopy 

tekset 

td [-eurn] [GPS file ...] 

DESCRIPTION 

All of the commands described below reside in /usr/bin/graf (see graphic s{\G)). 

hpd Hpd translates a GPS (see gps (4)), to instructions for the Hewlett-Packard 7221A Graphics 

Plotter. A viewing window is computed from the maximum and minimum points in file unless 
the -u or -r option is provided. If no file is given, the standard input is assumed. Options are: 

c n Select character set n, n between 0 and 5 (see the HP7221A Plotter Operating and 
Programming Manual , Appendix A). 

p n Select pen numbered n, n between 1 and 4 inclusive. 

r n Window on GPS region n , n between 1 and 25 inclusive. 

s n Slant characters n degrees clockwise from the vertical. 

u Window on the entire GPS universe. 

xd« Set x displacement of the viewport's lower left corner to n inches. 
x\n Set width of viewport to n inches. 

yd n Set y displacement of the viewport’s lower left corner to n inches, 
y xn Set height of viewport to n inches. 

erase Erase sends characters to a Tektronix 4010 series storage terminal to erase the screen. 

hardcopy When issued at a Tektronix display terminal with a hard copy unit, hardcopy generates a screen 
copy on the unit. 

tekset Tekset sends characters to a Tektronix terminal to clear the display screen, set the display mode 
to alpha, and set characters to the smallest font. 

td Td translates a GPS to scope code for a Tektronix 4010 series storage terminal. A viewing win¬ 

dow is computed from the maximum and minimum points in file unless the -u or -r option is 
provided. If no file is given, the standard input is assumed. Options are: 

e Do not erase screen before initiating display. 

r n Display GPS region n, n between 1 and 25 inclusive. 

u Display the entire GPS universe. 

SEE ALSO 

ged(lG), graphics(lG), gps(4). 
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NAME 

ged - graphical editor 
SYNOPSIS 

ged [-euRrn] [GPS file ...] 

DESCRIPTION 

Ged is an interactive graphical editor used to display, construct, and edit GPS files on Tektronix 4010 series 
display terminals. If GPS file(s) are given, ged reads them into an internal display buffer and displays the 
buffer. The GPS in the buffer can then be edited. If - is given as a file name, ged reads a GPS from the 
standard input. 

Ged accepts the following command line options: 

e Do not erase the screen before the initial display. 
rn Display region number n. 

u Display the entire GPS universe. 

R Restricted shell invoked on use of !. 

A GPS file is composed of instances of three graphical objects: lines, arc, and text. Arc and lines objects 
have a start point, or object-handle, followed by zero or more points, or point-handles. Text has only an 
object-handle. The objects are positioned within a Cartesian plane, or universe, having 64K (-32K to 
+32K) points, or universe-units, on each axis. The universe is divided into 25 equal sized areas called 
regions. Regions are arranged in five rows of five squares each, numbered 1 to 25 from the lower left of the 
universe to the upper right. 

Ged maps rectangular areas, called windows, from the universe onto the display screen. Windows allow the 
user to view pictures from different locations and at different magnifications. The universe-window is the 
window with minimum magnification, i.e. the window that views the entire universe. The home-window is 
the window that completely displays the contents of the display buffer. 

COMMANDS 

Ged commands are entered in stages. Typically each stage ends with a <cr> (return). Prior to the final 
<cr> the command may be aborted by typing rubout. The input of a stage may be edited during the stage 
using the erase and kill characters of the calling shell. The prompt * indicates that ged is waiting at stage 1. 

Each command consists of a subset of the following stages: 

1. Command line 

A command line consists of a command name followed by argument(s) followed by a <cr>. 
A command name is a single character. Command arguments are either option( s) or & file¬ 
name. Options are indicated by a leading -. 

2. Text Text is a sequence of characters terminated by an unescaped <cr>. (120 lines of text maxi¬ 

mum.) 

3. Points Points is a sequence of one or more screen locations (maximum of 30) indicated either by 

the terminal crosshairs or by name. The prompt for entering points is the appearance of the 
crosshairs. When the crosshairs are visible, typing: 

sp (space) enters the current location as a point. The point is identified with a number. 

$n enters the previous point numbered n. 

>x labels the last point entered with the upper case letter x. 

$x enters the point labeled x. 

. establishes the previous points as the current points. At the start of a command the 
previous points are those locations given with the previous command. 
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= echoes the current points. 

$.n enters the point numbered n from the previous points. 

# erases the last point entered. 

@ erases all of the points entered. 

4. Pivot The pivot is a single location, entered by typing <cr> or by using the $ operator, and indi¬ 

cated with a *. 

5. Destination 

The destination is a single location entered by typing <cr> or by using $. 


COMMAND SUMMARY 

In the summary, characters typed by the user are printed in bold. Command stages are printed in italics. 
Arguments surrounded by brackets “[]” are optional. Parentheses “()” surrounding arguments separated 
by ‘ ‘or’ ’ means that exactly one of the arguments must be given. 


Construct commands: 
Arc 

Box 

Circle 

Hardware 

Lines 

Text 


[-echo,style,weight] points 
[-echo,style,weight] points 
[-echo,style,weight] points 
[-echo] text points 
[-echo,style,weight] points 

[-angle,echo,height,mid-point,right-point,text,weight] text points 


Edit commands: 

Delete 

Edit 

Kopy 

Move 

Rotate 

Scale 


(- (universe or view) or points ) 

[-angle,echo,height,style,weight] (- (universe or view) or points ) 
[-echo,points,x] points pivot destination 
[-echo,points,x] points pivot destination 
[-angle,echo,kopy,x] points pivot destination 
[-echo,factor,kopy,x] points pivot destination 


View commands: 

coordinates 

erase 

new-display 

object-handles 

point-handles 

view 

x 

zoom 


points 


(- (universe or view) or points ) 

(- (labelled-points or universe or view) or points ) 

(- (home or universe or region) or [-x] pivot destination ) 
[-view] points 
[-out] points 


Other commands: 

quit or Quit 
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read [-angle,echo,height,mid-point,right-point,text,weight] file-name [destination] 

set [-angle,echo,factor,height,kopy,mid-point,points, right-point,style,text,weight,x] 

write file-name 

Icommand 


Options: 

Options specify parameters used to construct, edit, and view graphical objects. If a parameter used by a 
command is not specifed as an option, the default value for the parameter will be used (see set below). The 
format of command options is 
-option [,option ] 

where option is keyletter[value\. Flags take on the values of true or false indicated by + and - respectively. 
If no value is given with a flag, true is assumed. 


Object options: 
angle?; 
echo 
factor?; 
height?; 
kopy 
mid-point 
points 
right-point 
styl etype 


text 

weight type 


Area options: 
home 
out 

region?; 

universe 

view 

x 


Angle of ?; degrees. 

When true, echo additions to the display buffer. 

Scale factor is ?; percent. 

Height of text is ?; universe-units (0<?;< 1280). 

When true, copy rather than move. 

When true, mid-point is used to locate text string. 

When true, operate on points otherwise operate on objects. 

When true, right-point is used to locate text string. 

Line style set to one of following types : 
so solid 

da dashed 

dd dot-dashed 

do dotted 

Id long-dashed 

When false, text strings are outlined rather than drawn. 

Sets line weight to one of following types : 
n narrow 

m medium 

b bold 

Reference the home-window. 

Reduce magnification. 

Reference region ?;. 

Reference the universe-window. 

Reference those objects currently in view. 

Indicate the center of the referenced area. 


COMMAND DESCRIPTIONS 
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Construct commands: 

Arc and Lines 

behave similarly. Each consists of a command line followed by points. The first point entered is the 
object-handle. Successive points are point-handles. Lines connects the handles in numerical order. 
Arc fits a curve to the handles (currently a maximum of 3 points will be fit with a circular arc; splines 
will be added in a later version). 

Box and Circle 

are special cases of Lines and Arc, respectively. Box generates a rectangle with sides parallel to the 
universe axes. A diagonal of the rectangle would connect the first point entered with the last point. 
The first point is the object-handle. Point-handles are created at each of the vertices. Circle gener¬ 
ates a circular arc centered about the point numbered zero and passing through the last point. The 
circle’s object-handle coincides with the last point. A point-handle is generated 180 degrees around 
the circle from the object-handle. 

Text and Hardware 

generate text objects. Each consists of a command line, text and points. Text is a sequence of char¬ 
acters delimited by <cr>. Multiple lines of text may be entered by preceding a cr with a backslash 
(i.e. \cr). The Text command creates software generated characters. Each line of software text is 
treated as a separate text object. The first point entered is the object-handle for the first line of text. 
The Hardware command sends the characters in text uninterpreted to the terminal. 


Edit commands: 

Edit commands operate on portions of the display buffer called defined-areas. A defined-area is referenced 
either with an area option or interactively. If an area option is not given, the perimeter of the defined-area is 
indicated by points. If no point is entered, a small defined-area is built around the location of the <cr>. 
This is useful to reference a single point. If only one point is entered, the location of the <cr> is taken in 
conjunction with the point to indicate a diagonal of a rectangle. A defined-area referenced by points will be 
outlined with dotted lines. 

Delete 

removes all objects whose object-handle lies within a defined-area. The universe option removes all 
objects and erases the screen. 

Edit modifies the parameters of the objects within a defined-area. Parameters that can be edited are: 
angle angle of text 
height height of text 
style style of lines and arc 
weight weight of lines, arc, and text. 

Kopy (or Move) 

copies (or moves) object- and/or point-handles within a defined-area by the displacement from the 
pivot to the destination. 

Rotate 

rotates objects within a defined-area around the pivot. If the kopy flag is true then the objects are 
copied rather than moved. 

Scale For objects whose object-handles are within a defined-area, point displacements from the pivot are 
scaled by factor percent. If the kopy flag is true then the objects are copied rather than moved. 

View commands: 
coordinates 

prints the location of point(s) in universe- and screen-units, 
erase clears the screen (but not the display buffer). 
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new-display 

erases the screen then displays the display buffer, 
object-handles (or point-handles) 

labels object- (and/or point-handles) that lie within the defined-area with O (or P). point-handles 
identifies labelled points when the labelled-points flag is true. 

view moves the window so that the universe point corresponding to the pivot coincides with the screen 
point corresponding to the destination. Options for home, universe, and region display particular 
windows in the universe. 

x indicates the center of a defined-area. Option view indicates the center of the screen, 
zoom 

decreases (zoom out) or increases the magnification of the viewing window based on the defined- 
area. For increased magnification, the window is set to circumscribe the defined-area. For a decrease 
in magnification the current window is inscribed within the defined-area. 


Other commands: 
quit or Quit 

exit from ged. quit responds with ? if the display buffer has not been written since the last 
modification. 

read inputs the contents of a file. If the file contains a GPS it is read directly. If the file contains text it is 
converted into text object(s). The first line of a text file begins at destination. 

set when given option(s) resets default parameters, otherwise it prints current default values. 

write outputs the contents of the display buffer to a file. 

! escapes ged to execute a UNIX System command. 

? lists ged commands. 

SEE ALSO 

gdev(lG), graphics(lG), sh( 1), gps(4). 

An Introduction to the Graphical Editor in the UNIX System Graphics Guide. 
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NAME 

get - get a version of an SCCS file 
SYNOPSIS 

get [-rSID] [—ccutoff] [-ilist] [-xlist] [-aseq-no.] [-k] [-e] [-l[p]] [-p] [-m] [-n] [-s] [-b] [-g] [-t] file 
DESCRIPTION 

Get generates an ASCII text file from each named SCCS file according to the specifications given by its 
keyletter arguments, which begin with The arguments may be specified in any order, but all keyletter 
arguments apply to all named SCCS files. If a directory is named, get behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files (last component of the path name does 
not begin with s.) and unreadable files are silently ignored. If a name of - is given, the standard input is 
read; each line of the standard input is taken to be the name of an SCCS file to be processed. Again, non- 
SCCS files and unreadable files are silently ignored. 

The generated text is normally written into a file called the g-file whose name is derived from the SCCS file 
name by simply removing the leading s.; (see also FILES, below). 

Each of the keyletter arguments is explained below as though only one SCCS file is to be processed, but the 
effects of any keyletter argument applies independently to each named file. 

-r SID The SCCS .Identification string (SID) of the version (delta) of an SCCS file to be retrieved. 

Table 1 below shows, for the most useful cases, what version of an SCCS file is retrieved (as 
well as the SID of the version to be eventually created by delta( 1) if the -e keyletter is also 
used), as a function of the SID specified. 

-ccutoff Cutoff date-time, in the form: 

YY[MM[DD[HH[MM[SS]]]]] 

No changes (deltas) to the SCCS file which were created after the specified cutoff date-time are 
included in the generated ASCII text file. Units omitted from the date-time default to their maxi¬ 
mum possible values; that is, -c7502 is equivalent to -C750228235959. Any number of non¬ 
numeric characters may separate the various 2 digit pieces of the cutoff date-time. This feature 
allows one to specify a cutoff date in the form: "-C77/2/2 9:22:25". Note that this implies that 
one may use the %E% and %U% identification keywords (see below) for nested gets within, say 
the input to a send( 1C) command: 

~!get ”-c%E% %U%" s.file 

-e Indicates that the get is for the purpose of editing or making a change (delta) to the SCCS file via 

a subsequent use of delta( 1). The -e keyletter used in a get for a particular version (SID) of the 
SCCS file prevents further gets for editing on the same SID until delta is executed or the j (joint 
edit) flag is set in the SCCS file (see admin{ 1)). Concurrent use of get -e for different SIDs is 
always allowed. 

If the g-file generated by get with an -e keyletter is accidentally ruined in the process of editing 
it, it may be regenerated by re-executing the get command with the -k keyletter in place of the 
-e keyletter. 

SCCS file protection specified via the ceiling, floor, and authorized user list stored in the SCCS 
file (see admin ( 1)) are enforced when the -e keyletter is used. 

-b Used with the -e keyletter to indicate that the new delta should have an SID in a new branch as 

shown in Table 1. This keyletter is ignored if the b flag is not present in the file (see admin{ 1)) 
or if the retrieved delta is not a leaf delta. (A leaf delta is one that has no successors on the 
SCCS file tree.) 

Note: A branch delta may always be created from a non-leaf delta. 

-i list A list of deltas to be included (forced to be applied) in the creation of the generated file. The list 

has the following syntax: 
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<list> ::= <range> | <list> , <range> 

<range> ::= SID | SID - SID 

SID, the SCCS Identification of a delta, may be in any form shown in the “SID Specified” col¬ 
umn of Table 1. Partial SIDs are interpreted as shown in the “SID Retrieved” column of 
Table 1. 

-xlist A list of deltas to be excluded (forced not to be applied) in the creation of the generated file. See 
the -i keyletter for the list format. 

-k Suppresses replacement of identification keywords (see below) in the retrieved text by their 

value. The -k keyletter is implied by the -e keyletter. 

-l[p] Causes a delta summary to be written into an l-file. If -lp is used then an I-file is not created; the 
delta summary is written on the standard output instead. See FILES for the format of the l-file. 

-p Causes the text retrieved from the SCCS file to be written on the standard output. No g-file is 

created. All output which normally goes to the standard output goes to file descriptor 2 instead, 
unless the -s keyletter is used, in which case it disappears. 

-s Suppresses all output normally written on the standard output. However, fatal error messages 

(which always go to file descriptor 2) remain unaffected. 

-m Causes each text line retrieved from the SCCS file to be preceded by the SID of the delta that 

inserted the text line in the SCCS file. The format is: SID, followed by a horizontal tab, followed 
by the text line. 

-n Causes each generated text line to be preceded with the %M% identification keyword value (see 

below). The format is: %M% value, followed by a horizontal tab, followed by the text line. 
When both the -m and -n keyletters are used, the format is: %M% value, followed by a horizon¬ 
tal tab, followed by the -m keyletter generated format. 

-g Suppresses the actual retrieval of text from the SCCS file. It is primarily used to generate an I- 

file, or to verify the existence of a particular SID. 

-t Used to access the most recently created (“top”) delta in a given release (e.g., -rl), or release 

and level (e.g., -rl.2). 

-a seq-no. The delta sequence number of the SCCS file delta (version) to be retrieved (see sccsfile( 5)). This 
keyletter is used by the comb( 1) command; it is not a generally useful keyletter, and users 
should not use it. If both the -r and -a keyletters are specified, the -a keyletter is used. Care 
should be taken when using the -a keyletter in conjunction with the -e keyletter, as the SID of 
the delta to be created may not be what one expects. The -r keyletter can be used with the -a 
and -e keyletters to control the naming of the SID of the delta to be created. 

For each file processed, get responds (on the standard output) with the SID being accessed and with the 
number of lines retrieved from the SCCS file. 

If the -e keyletter is used, the SID of the delta to be made appears after the SID accessed and before the 
number of lines generated. If there is more than one named file or if a directory or standard input is named, 
each file name is printed (preceded by a new-line) before it is processed. If the -i keyletter is used included 
deltas are listed following the notation “Included”; if the -x keyletter is used, excluded deltas are listed 
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following the notation “Excluded”. 


TABLE 1. Determination of SCCS Identification String 


SID* 

-b Keyletter 

Other 

SID 

SID of Delta 

Specified 

Usedf 

Conditions 

Retrieved 

to be Created 

none$ 

no 

R defaults to rnR 

mR.mL 

mR.(mL+l) 

nonet 

yes 

R defaults to rnR 

mR.mL 

mR.mL.(mB+l).l 

R 

no 

R > rnR 

mR.mL 

R.l*** 

R 

no 

R = mR 

mR.mL 

mR.(mL+l) 

R 

yes 

R > mR 

mR.mL 

mR.mL.(mB+l).l 

R 

yes 

R = mR 

mR.mL 

mR.mL.(mB+l).l 

R 

- 

R < mR and 

R does not exist 

hR.ml,** 

hR.mL.(mB+l).l 



Trunk succ.# 



R 

— 

in release > R 

and R exists 

R.mL 

R.mL.(mB + l).l 

R.L 

no 

No trunk succ. 

R.L 

R.(L+1) 

R.L 

yes 

No trunk succ. 

R.L 

R.L.(mB+l).l 

R.L 

- 

Trunk succ. 

in release > R 

R.L 

R.L.(mB+l).l 

R.L.B 

no 

No branch succ. 

R.L.B.mS 

R.L.B.(mS+1) 

R.L.B 

yes 

No branch succ. 

R.L.B.mS 

R.L.(mB+l).l 

R.L.B.S 

no 

No branch succ. 

R.L.B.S 

R.L.B.(S+l) 

R.L.B.S 

yes 

No branch succ. 

R.L.B.S 

R.L.(mB+l).l 

R.L.B.S 

- 

Branch succ. 

R.L.B.S 

R.L.(mB+l).l 


** 

# 

f 

$ 


“R”, “L”, “B”, and “S” are the “release”, “level", “branch", and “sequence” components of 
the SID, respectively; “m” means “maximum”. Thus, for example, “R.mL” means “the maximum 
level number within release R”; “R.L.(mB+l).l” means “the first sequence number on the new 
branch (i.e., maximum branch number plus one) of level L within release R". Note that if the SID 
specified is of the form “R.L”, “R.L.B”, or “R.L.B.S”, each of the specified components must 
exist. 

“hR” is the highest existing release that is lower than the specified, nonexistent , release R. 

This is used to force creation of th e first delta in a new release. 

Successor. 

The -b keyletter is effective only if the b flag (see admin (1)) is present in the file. An entry of - 
means “irrelevant”. 

This case applies if the d (default SID) flag is not present in the file. If the d flag is present in the file, 
then the SID obtained from the d flag is interpreted as if it had been specified on the command line. 
Thus, one of the other cases in this table applies. 


IDENTIFICATION KEYWORDS 

Identifying information is inserted into the text retrieved from the SCCS file by replacing identification 
keywords with their value wherever they occur. The following keywords may be used in the text stored in 
an SCCS file: 


Keyword Value 

%M% Module name: either the value of the m flag in the file (see admin( 1)), or if absent, the name of 
the SCCS file with the leading s. removed. 

%1% SCCS identification (SID) (%R%.%L%.%B%.%S%) of the retrieved text. 

%R% Release. 
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%L% Level. 

%B% Branch. 

%S% Sequence. 

%D% Current date (YY/MM/DD). 

%H% Current date (MM/DD/YY). 

%T% Current time (HH:MM:SS). 

%E% Date newest applied delta was created (YY/MM/DD). 

%G% Date newest applied delta was created (MM/DD/YY). 

%U% Time newest applied delta was created (HH:MM:SS). 

%Y% Module type: value of the t flag in the SCCS file (see admin{ 1)). 

%F% SCCS file name. 

%P% Fully qualified SCCS file name. 

%Q% The value of the q flag in the file (see admin{ 1)). 

%C% Current line number. This keyword is intended for identifying messages output by the program 
such as “this shouldn’t have happened" type errors. It is not intended to be used on every line 
to provide sequence numbers. 

%Z% The 4-character string @(#) recognizable by what{ 1). 

%W% A shorthand notation for constructing what( 1) strings for the UNIX System program files. 
%W% = %Z%%M%<horizontal-tab>%I% 

%A% Another shorthand notation for constructing whati I) strings for non-UNIX System program files. 

%A% = %Z%%Y% %M% 

FILES 

Several auxiliary files may be created by get. These files are known generically as the g-file, l-file, p-file, 
and z-file. The letter before the hyphen is called the tag. An auxiliary file name is formed from the SCCS 
file name: the last component of all SCCS file names must be of the form s .module-name, the auxiliary files 
are named by replacing the leading s with the tag. The g-file is an exception to this scheme: the g-file is 
named by removing the s. prefix. For example, s.xyz.c, the auxiliary file names would be xyz.c, l.xyz.c, 
p.xyz.c, and z.xyz.c, respectively. 

The g-file, which contains the generated text, is created in the current directory (unless the -p keyletter is 
used). A g-file is created in all cases, whether or not any lines of text were generated by the get. It is 
owned by the real user. If the -k keyletter is used or implied its mode is 644; otherwise its mode is 444. 
Only the real user need have write permission in the current directory. 

The l-file contains a table showing which deltas were applied in generating the retrieved text. The l-file is 
created in the current directory if the -1 keyletter is used; its mode is 444 and it is owned by the real user. 
Only the real user need have write permission in the current directory. 

Lines in the l-file have the following format: 

a. A blank character if the delta was applied; 

* otherwise. 

b. A blank character if the delta was applied or wasn't applied and ignored; 

* if the delta wasn’t applied and wasn’t ignored. 

c. A code indicating a “special” reason why the delta was or was not applied: 

“I”: Included. 

“X”: Excluded. 

“C”: Cut off (by a -c keyletter). 

d. Blank. 

e. SCCS identification (SID). 

f. Tab character. 

g. Date and time (in the form YY/MM/DD HH:MM:SS) of creation. 

h. Blank. 

i. Login name of person who created delta. 
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The comments and MR data follow on subsequent lines, indented one horizontal tab character. A 
blank line terminates each entry. 

The p-file is used to pass information resulting from a get with an -e keyletter along to delta. Its contents 
are also used to prevent a subsequent execution of get with an -e keyletter for the same SID until delta is 
executed or the joint edit flag, j, (see admin { 1)) is set in the SCCS file. The p-file is created in the directory 
containing the SCCS file and the effective user must have write permission in that directory. Its mode is 
644 and it is owned by the effective user. The format of the p-file is: the gotten SID, followed by a blank, 
followed by the SID that the new delta will have when it is made, followed by a blank, followed by the 
login name of the real user, followed by a blank, followed by the date-time the get was executed, followed 
by a blank and the -i keyletter argument if it was present, followed by a blank and the -x keyletter argu¬ 
ment if it was present, followed by a new-line. There can be an arbitrary number of lines in the p-file at any 
time; no two lines can have the same new delta SID. 

The z-file serves as a lock-out mechanism against simultaneous updates. Its contents are the binary (2 
bytes) process ID of the command (i.e., get) that created it. The z-file is created in the directory containing 
the SCCS file for the duration of get. The same protection restrictions as those for the p-file apply for the 
z-file. The z-file is created mode 444. 

SEE ALSO 

admin(l), delta(l), help(l), prs(l), what(l), sccsfile(4). 

Source Code Control System in the UNIX System Support Tools Guide. 

DIAGNOSTICS 

Use help) 1) for explanations. 

BUGS 

If the effective user has write permission (either explicitly or implicitly) in the directory containing the 
SCCS files, but the real user doesn’t, then only one file may be named when the -e keyletter is used. 
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NAME 

getopt - parse command options 
SYNOPSIS 

set — ' getopt optstring $*' 

DESCRIPTION 

Getopt is used to break up options in command lines for easy parsing by shell procedures and to check for 
legal options. Optstring is a string of recognized option letters (see getopt( 3C)); if a letter is followed by a 
colon, the option is expected to have an argument which may or may not be separated from it by white 
space. The special option — is used to delimit the end of the options. If it is used explicitly, getopt will 
recognize it; otherwise, getopt will generate it; in either case, getopt will place it at the end of the options. 
The shell’s positional parameters ($1 $2 ...) are reset so that each option is preceded by a - and is in its 
own positional parameter; each option argument is also parsed into its own positional parameter. 

EXAMPLE 

The following code fragment shows how one might process the arguments for a command that can take the 
options a or b, as well as the option o, which requires an argument: 

set — v getopt abo: $* v 

if [ $? != 0 ] 

then 

echo $USAGE 
exit 2 
fi 

for i in $* 
do 

case $i in 

-a I -b) FLAG=$i; shift;; 

-o) OARG=$2; shift 2;; 

—) shift; break;; 

esac 

done 

This code will accept any of the following as equivalent: 

cmd -aoarg file file 
cmd -a -o arg file file 
cmd -oarg -a file file 
cmd -a -oarg — file file 

SEE ALSO 

sh(l), getopt(3C). 

DIAGNOSTICS 

Getopt prints an error message on the standard error when it encounters an option letter not included in 
optstring. 
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NAME 

graph - draw a graph 

SYNOPSIS 

graph [ options ] 

DESCRIPTION 

Graph with no options takes pairs of numbers from the standard input as abscissas and ordinates of a graph. 
Successive points are connected by straight lines. The graph is encoded on the standard output for display 
by the tplot( 1G) filters. 

If the coordinates of a point are followed by a non-numeric string, that string is printed as a label beginning 
on the point. Labels may be surrounded with quotes ", in which case they may be empty or contain blanks 
and numbers; labels never contain new-lines. 

The following options are recognized, each as a separate argument: 

-a Supply abscissas automatically (they are missing from the input); spacing is given by the next 

argument (default 1). A second optional argument is the starting point for automatic abscissas 
(default 0 or lower limit given by -x). 

-b Break (disconnect) the graph after each label in the input. 

-c Character string given by next argument is default label for each point. 

-g Next argument is grid style, 0 no grid, 1 frame with ticks, 2 full grid (default). 

-1 Next argument is label for graph. 

-m Next argument is mode (style) of connecting lines: 0 disconnected, 1 connected (default). 

Some devices give distinguishable line styles for other small integers (e.g., the Tektronix 4014: 
2=dotted, 3=dash-dot, 4=short-dash, 5=long-dash). 

-s Save screen, don't erase before plotting. 

-x [ 1 ] If 1 is present, x axis is logarithmic. Next 1 (or 2) arguments are lower (and upper) x limits. 

Third argument, if present, is grid spacing on x axis. Normally these quantities are determined 
automatically. 

-y [ 1 ] Similarly for y. 

-h Next argument is fraction of space for height. 

-w Similarly for width. 

-r Next argument is fraction of space to move right before plotting. 

-u Similarly to move up before plotting. 

-t Transpose horizontal and vertical axes. (Option -x now applies to the vertical axis.) 

A legend indicating grid range is produced with a grid unless the -s option is present. If a specified lower 
limit exceeds the upper limit, the axis is reversed. 

SEE ALSO 

graphics(lG), spline(lG), tplot(lG). 

BUGS 

Graph stores all points internally and drops those for which there isn’t room. 

Segments that run out of bounds are dropped, not windowed. 

Logarithmic axes may not be reversed. 
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NAME 

graphics - access graphical and numerical commands 

SYNOPSIS 

graphics [ -r ] 

DESCRIPTION 

Graphics appends the path name /usr/bin/graf to the current $PATH value, changes the primary shell 
prompt to ", and executes a new shell. The directory /usr/bin/graf contains all of the Graphics subsystem 
commands. If the -r option is given, access to the graphical commands is created in a restricted environ¬ 
ment; that is, $PATH is set to /:rbin:/usr/rbin:/bin:/usr/bin:/usr/bin/graf and the restricted shell, rsh, is 
invoked. To restore the environment that existed prior to issuing the graphics command, type EOT 
(control-d on most terminals). To logoff from the graphics environment, type quit. 

The command line format for a command in graphics is command name followed by argument (s). An 
argument may be a file name or an option string. A file name is the name of any UNIX System file except 
those beginning with -. The file name - is the name for the standard input. An option string consists of - 
followed by one or more option(s). An option consists of a keyletter possibly followed by a value. Options 
may be separated by commas. 

The graphical commands have been partitioned into four groups. 

Commands that manipulate and plot numerical data; see stat( 1G). 

Commands that generate tables of contents; see toc( 1G). 

Commands that interact with graphical devices; see gdev( 1G) and ged( 1G). 

A collection of graphical utility commands; see gutil( 1G). 

A list of the graphics commands can be generated by typing whatis in the graphics environment. 

SEE ALSO 

gdev(lG), ged(lG), gutil(lG), stat(lG), toc(lG), gps(4). 

UNIX System Graphics Guide. 
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NAME 

greek - select terminal filter 

SYNOPSIS 

greek [ -Tterminal ] 

DESCRIPTION 

Greek is a filter that reinterprets the extended character set, as well as the reverse and half-line motions, of a 
128-character TELETYPE.nh 

Teletypewriter Model 37 terminal (which is the nroff default terminal) for certain other terminals. Special 
characters are simulated by overstriking, if necessary and possible. If the argument is omitted, greek 
attempts to use the environment variable $TERM (see environ( 5)). The following terminals are recognized 
currently: 


300 

DASI 300. 

300-12 

DASI 300 in 12-pitch. 

300s 

DASI 300s. 

300s-12 

DASI 300s in 12-pitch. 

450 

DASI 450. 

450-12 

DASI 450 in 12-pitch. 

1620 

Diablo 1620 (alias DASI 450). 

1620-12 

Diablo 1620 (alias DASI 450) in 12-pitch. 

2621 

Hewlett-Packard 2621, 2640, and 2645. 

2640 

Hewlett-Packard 2621, 2640, and 2645. 

2645 

Hewlett-Packard 2621, 2640, and 2645. 

4014 

Tektronix 4014. 

hp 

Hewlett-Packard 2621, 2640, and 2645. 

tek 

Tektronix 4014. 


FILES 

/usr/bin/300 

/usr/bin/300s 

/usr/bin/4014 

/usr/bin/450 

/usr/bin/hp 

SEE ALSO 

300(1), 4014(1), 450(1), eqn(l), hp(l), mm(l), tplot(lG), nroff(l), environ(5), greek(5), term(5). 
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NAME 

grep, egrep, fgrep - search a file for a pattern 
SYNOPSIS 

grep [ options ] expression [ files ] 
egrep [ options ] [ expression ] [ files ] 
fgrep [ options ] [ strings ] [ files ] 

DESCRIPTION 

Commands of the grep family search the input files (standard input default) for lines matching a pattern. 
Normally, each line found is copied to the standard output. Grep patterns are limited regular expression s in 
the style of ed( 1); it uses a compact non-deterministic algorithm. Egrep patterns are full regular 
expressions', it uses a fast deterministic algorithm that sometimes needs exponential space. Fgrep patterns 
are fixed strings ; it is fast and compact. The following options are recognized: 

-v All lines but those matching are printed. 

-x (Exact) only lines matched in their entirety are printed (fgrep only). 

-c Only a count of matching lines is printed. 

-1 Only the names of files with matching lines are listed (once), separated by new-lines. 

-n Each line is preceded by its relative line number in the file. 

-b Each line is preceded by the block number on which it was found. This is sometimes useful in 
locating disk block numbers by context. 

-s The error messages produced for nonexistent or unreadable files are suppressed (grep only). 

-e expression 

Same as a simple expression argument, but useful when the expression begins with a - (does not 
work with grep). 

-f file The regular expression (egrep) or strings list (fgrep) is taken from the file. 

In all cases, the file name is output if there is more than one input file. Care should be taken when using the 
characters $, *, [, ', |, (, ), and \ in expression , because they are also meaningful to the shell. It is safest to 
enclose the entire expression argument in single quotes 

Fgrep searches for lines that contain one of the strings separated by new-lines. 

Egrep accepts regular expressions as in ed( 1), except for\( and \), with the addition of: 

1. A regular expression followed by + matches one or more occurrences of the regular expression. 

2. A regular expression followed by ? matches 0 or 1 occurrences of the regular expression. 

3. Two regular expressions separated by I or by a new-line match strings that are matched by either. 

4. A regular expression may be enclosed in parentheses () for grouping. 

The order of precedence of operators is [ ], then * ? +, then concatenation, then I and new-line. 

SEE ALSO 

ed(l), sed(l), sh(l). 

DIAGNOSTICS 

Exit status is 0 if any matches are found, 1 if none, 2 for syntax errors or inaccessible files (even if matches 
were found). 

BUGS 

Ideally there should be only one grep, but we don’t know a single algorithm that spans a wide enough 
range of space-time tradeoffs. 

Lines are limited to 256 characters; longer lines are truncated. 

Egrep does not recognize ranges, such as [a-z], in character classes. 
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NAME 

help - ask for help 

SYNOPSIS 

help [args] 

DESCRIPTION 

Help finds information to explain a message from a command or explain the use of a command. Zero or 
more arguments may be supplied. If no arguments are given, help will prompt for one. 

The arguments may be either message numbers (which normally appear in parentheses following messages) 
or command names, of one of the following types: 

type 1 Begins with non-numerics, ends in numerics. The non-numeric prefix is usually 
an abbreviation for the program or set of routines which produced the message 
(e.g., ge6, for message 6 from the get command). 

type 2 Does not contain numerics (as a command, such as get) 

type 3 Is all numeric (e.g., 212) 

The response of the program will be the explanatory information related to the argument, if there is any. 
When all else fails, try “help stuck”. 

FILES 

/usr/lib/help directory containing files of message text. 

/usr/lib/help/helploc file containing locations of help files not in /usr/lib/help. 

DIAGNOSTICS 

Use help( 1) for explanations. 
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NAME 

hp - handle special functions of HP 2640 and 2621-series terminals 

SYNOPSIS 

hp [ -e ] [ -m ] 

DESCRIPTION 

Hp supports special functions of the Hewlett-Packard 2640 series of terminals, with the primary purpose of 
producing accurate representations of most nroff output. A typical use is: 

nroff -h files ... I hp 

Regardless of the hardware options on your terminal, hp tries to do sensible things with underlining and 
reverse line-feeds. If the terminal has the ‘ ‘display enhancements’' feature, subscripts and superscripts can 
be indicated in distinct ways. If it has the “mathematical-symbol” feature, Greek and other special charac¬ 
ters can be displayed. 

The flags are as follows: 

-e It is assumed that your terminal has the ‘ ‘display enhancements’ ’ feature, and so maximal use is 
made of the added display modes. Overstruck characters are presented in the Underline mode. 
Superscripts are shown in Half-bright mode, and subscripts in Half-bright, Underlined mode. If 
this flag is omitted, hp assumes that your terminal lacks the ‘ ‘display enhancements’ ’ feature. In 
this case, all overstruck characters, subscripts, and superscripts are displayed in Inverse Video 
mode, i.e., dark-on-light, rather than the usual light-on-dark. 

-m Requests minimization of output by removal of new-lines. Any contiguous sequence of 3 or more 
new-lines is converted into a sequence of only 2 new-lines; i.e., any number of successive blank 
lines produces only a single blank output line. This allows you to retain more actual text on the 
screen. 

With regard to Greek and other special characters, hp provides the same set as does 500(1), except that 
“not” is approximated by a right arrow, and only the top half of the integral sign is shown. The display is 
adequate for examining output from neqn. 

DIAGNOSTICS 

“line too long” if the representation of a line exceeds 1,024 characters. 

The exit codes are 0 for normal termination, 2 for all errors. 

SEE ALSO 

300(1), col(l), eqn(l), greek(l), nroff(l), tbl(l). 

BUGS 

An ‘ ‘overstriking sequence’ ’ is defined as a printing character followed by a backspace followed by another 
printing character. In such sequences, if either printing character is an underscore, the other printing char¬ 
acter is shown underlined or in Inverse Video; otherwise, only the first printing character is shown (again, 
underlined or in Inverse Video). Nothing special is done if a backspace is adjacent to an ASCII control 
character. Sequences of control characters (e.g., reverse line-feeds, backspaces) can make text “disap¬ 
pear”; in particular, tables generated by tbl(l) that contain vertical lines will often be missing the lines of 
text that contain the “foot” of a vertical line, unless the input to hp is piped through col( 1). 

Although some terminals do provide numerical superscript characters, no attempt is made to display them. 
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NAME 

hpio - HP 2645A terminal tape file archiver 

SYNOPSIS 

hpio -o[rc] file ... 

hpio -i[rta] [-n count] 

DESCRIPTION 

Hpio is designed to take advantage of the tape drives on Hewlett Packard 2645A terminals. Up to 255 
UNIX System files can be archived onto a tape cartridge for off-line storage or for transfer to another UNIX 
System. The actual number of files depends on the sizes of the files. One file of about 115,000 bytes will 
almost fill a tape cartridge. Almost 300 1-byte files will fit on a tape, but the terminal will not be able to 
retrieve files after the first 255. This manual page is not intended to be a guide for using tapes on HP 2645A 
terminals, but tries to give enough information to be able to create and read tape archives and to position a 
tape for access to a desired file in an archive. 

Hpio -o (copy out) copies the specified file(s), together with path name and status information to a tape 
drive on your terminal (which is assumed to be positioned at the beginning of a tape or immediately after a 
tape mark). The left tape drive is used by default. Each file is written to a separate tape file and terminated 
with a tape mark. When hpio finishes, the tape is positioned following the last tape mark written. 

Hpio -i (copy in) extracts a file(s) from a tape drive (which is assumed to be positioned at the beginning of 
a file that was previously written by a hpio -o). The default action extracts the next file from the left tape 
drive. 

Hpio always leaves the tape positioned after the last file read from or written to the tape. Tapes should 
always be rewound before the terminal is turned off. To rewind a tape depress the green function button, 
then function key 5, and then select the appropriate tape drive by depressing either function key 5 for the 
left tape drive or function key 6 for the right. If several files have been archived onto a tape, the tape may 
be positioned at the beginning of a specific file by depressing the green function button, then function key 
8, followed by typing the desired file number (1-255) with no RETURN, and finally function key 5 for the 
left tape or function key 6 for the right. The desired file number may also be specified by a signed number 
relative to the current file number. 

The meanings of the available options are: 

r Use the right tape drive. 

c Include a checksum at the end of each file. The checksum is always checked by hpio -i for each 

file written with this option by hpio -o. 

n count The number of input files to be extracted is set to count. If this option is not given, count defaults 
to 1. An arbitrarily large count may be specified to extract all files from the tape. Hpio will stop at 
the end of data mark on the tape. 

t Print a table of contents only. No files are created. Printed information gives the file size in bytes, 

the file name, the file access modes, and whether or not a checksum is included for the file, 
a Ask before creating a file. Hpio -i normally prints the file size and name, creates and reads in the 

file, and prints a status message when the file has been read in. If a checksum is included with the 
file, it reports whether the checksum matched its computed value. With this option, the file size 
and name are printed followed by a ?. Any response beginning with y or Y will cause the file to be 
copied in as above. Any other response will cause the file to be skipped. 

FILES 

/dev/tty?? 

to block messages while accessing a tape 

SEE ALSO 

2645A Display Station User’s Manual , Hewlett-Packard Company, Part Number 02645-90001. 
DIAGNOSTICS 
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BREAK 

An interrupt signal terminated processing. 

Can’t create 'file'. 

File system access permissions did not allow file to be created. 

Can’t get tty options on stdout. 

Hpio was unable to get the input-output control settings associated with the terminal. 

Can’t open file'. 

File could not be accessed to copy it to tape. 

End of Tape. 

No tape record was available when a read from a tape was requested. An end of data mark is the 
usual reason for this, but it may also occur if the wrong tape drive is being accessed and no tape is 
present. 

file' not a regular file. 

File is a directory or other special file. Only regular files will be copied to tape. 

Readcnt = rc, termcnt = tc. 

Flpio expected to read rc bytes from the next block on the tape, but the block contained tc bytes. 
This is caused by having the tape improperly positioned or by a tape block being mangled by inter¬ 
ference from other terminal I/O. 

Skip to next file failed. 

An attempt to skip over a tape mark failed. 

Tape mark write failed. 

An attempt to write a tape mark at the end of a file failed. 

Write failed. 

A tape write failed. This is most frequently caused by specifying the wrong tape drive, running off 
the end of the tape, or trying to write on a tape that is write protected. 

WARNINGS 

Tape I/O operations may copy bad data if any other I/O involving the terminal occurs. Do not attempt any 
type ahead while hpio is running. Hpio turns off write permissions for other users while it is running, but 
processes started asynchronously from your terminal can still interfere. The most common indication of 
this problem, while a tape is being written, is the appearance of characters on the display screen that should 
have been copied to tape. 

The keyboard, including the terminal’s BREAK key, is locked during tape write operations; the BREAK key 
is only functional between writes. 

Hpio must have complete control of the attributes of the terminal to communicate with the tape drives. 
Interaction with commands such as cm (1C) may interfere and prevent successful operation. 

BUGS 

Some binary files contain sequences that will confuse the terminal. 

An hpio -i that encounters the end of data mark on the tape (e.g., scanning the entire tape with hpio -itn 
300), leaves the tape positioned after the end of data mark. If a subsequent hpio -o is done at this point, 
the data will not be retrievable. The tape must be repositioned manually using the terminal’s FIND FILE -1 
operation (depress the green function button, function key 8, and then function key 5 for the left tape or 
function key 6 for the right tape) before the hpio -o is started. 

If an interrupt is received by hpio while a tape is being written, the terminal may be left with the keyboard 
locked. If this happens, the terminal’s RESET TERMINAL key will unlock the keyboard. 
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NAME 

hyphen - find hyphenated words 

SYNOPSIS 

hyphen [ files ] 

DESCRIPTION 

Hyphen finds all the hyphenated words ending lines in files and prints them on the standard output. If no 
arguments are given, the standard input is used; thus, hyphen may be used as a filter. 

EXAMPLE 

The following will allow the proofreading of nroff' s hyphenation in texlfile. 
mm textfile I hyphen 

SEE ALSO 

mm(l), troffd). 

BUGS 

Hyphen can’t cope with hyphenated italic (i.e., underlined) words; it will often miss them completely, or 
mangle them. 

Hyphen occasionally gets confused, but with no ill effects other than spurious extra output. 
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NAME 

id - print user and group IDs and names 

SYNOPSIS 

id 

DESCRIPTION 

Id writes a message on the standard output giving the user and group IDs and the corresponding names of 
the invoking process. If the effective and real IDs do not match, both are printed. 

SEE ALSO 

logname(l), getuid(2). 
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NAME 

ipcrm - remove a message queue, semaphore set or shared memory id 

SYNOPSIS 

ipcrm [ options ] 

DESCRIPTION 

Ipcrm will remove one or more specified message, semaphore or shared memory identifiers. The identifiers 

are specified by the following options: 

-q msqid removes the message queue identifier msqid from the system and destroys the message 
queue and data structure associated with it. 

-m shmid removes the shared memory identifier shmid from the system. The shared memory segment 
and data structure associated with it are destroyed after the last detach. 

-s semid removes the semaphore identifier semid from the system and destroys the set of semaphores 
and data structure associated with it. 

-Q msgkey removes the message queue identifier, created with key msgkey, from the system and 
destroys the message queue and data structure associated with it. 

-M shmkey removes the shared memory identifier, created with key shmkey, from the system. The 
shared memory segment and data structure associated with it are destroyed after the last 
detach. 

-S semkey removes the semaphore identifier, created with key semkey, from the system and destroys the 
set of semaphores and data structure associated with it. 

The details of the removes are described in msgctl( 2), shmctl( 2), and semctl( 2). The identifiers and keys 

may be found by using ipcsi I). 

SEE ALSO 

ipcs(l), msgctl(2), msgget(2), msgop(2), semctl(2), semget(2), semop(2), shmctl(2), shmget(2), shmop(2). 
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NAME 

ipcs - report inter-process communication facilities status 

SYNOPSIS 

ipcs [ options ] 

DESCRIPTION 

Ipcs prints certain information about active inter-process communication facilities. Without options, infor¬ 
mation is printed in short format for message queues, shared memory, and semaphores that are currently 
active in the system. Otherwise, the information that is displayed is controlled by the following options: 

354155.sp0u 

-q Print information about active message queues. 

-m Print information about active shared memory segments. 

-s Print information about active semaphores. 

If any of the options -q, -m, or -s are specified, information about only those indicated will be printed. If 

none of these three are specified, information about all three will be printed. 

-b Print biggest allowable size information. (Maximum number of bytes in messages on queue for 
message queues, size of segments for shared memory, and number of semaphores in each set for 
semaphores.) See below for meaning of columns in a listing. 

-c Print creator’s login name and group name. See below. 

-o Print information on outstanding usage. (Number of messages on queue and total number of bytes 
in messages on queue for message queues and number of processes attached to shared memory 
segments.) 

-p Print process number information. (Process ID of last process to send a message and process ID of 
last process to receive a message on message queues and process ID of creating process and pro¬ 
cess ID of last process to attach or detach on shared memory segments) See below. 

-t Print time information. (Time of the last control operation that changed the access permissions for 
all facilities. Time of last msgsnd and last msgrcv on message queues, last shmat and last shmdt 
on shared memory, last semop( 2) on semaphores.) See below. 

-a Use all print options. (This is a shorthand notation for -b, -c, -o, -p, and -t.) 

-C corefile 

Use the file corefile in place of /dev/kmem. 

-N namelist 

The argument will be taken as the name of an alternate namelist (/unix is the default). 

The column headings and the meaning of the columns in an ipcs listing are given below; the letters in 
parentheses indicate the options that cause the corresponding heading to appear; all means that the heading 
always appears. Note that these options only determine what information is provided for each facility; they 
do not determine which facilities will be listed. 


T (all) 

ID (all) 

KEY (all) 

MODE (all) 


Type of the facility: 

q message queue; 

m shared memory segment; 

s semaphore. 

The identifier for the facility entry. 

The key used as an argument to msgget, semget, or shmget to create the facility entry. 
(Note: The key of a shared memory segment is changed to IPC PRIVATE when the 
segment has been removed until all processes attached to the segment detach it.) 

The facility access modes and flags: The mode consists of 11 characters that are inter¬ 
preted as follows: 

The first two characters are: 

R if a process is waiting on a msgrcv, 

S if a process is waiting on a msgsnd ; 

D if the associated shared memory segment has been removed. It will dis¬ 
appear when the last process attached to the segment detaches it; 
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C if the associated shared memory segment is to be cleared when the first 
attach is executed; 

- if the corresponding special flag is not set. 

The next 9 characters are interpreted as three sets of three bits each. The first set refers 
to the owner’s permissions; the next to permissions of others in the user-group of the 
facility entry; and the last to all others. Within each set, the first character indicates 
permission to read, the second character indicates permission to write or alter the facil¬ 
ity entry, and the last character is currently unused. 

The permissions are indicated as follows: 

r if read permission is granted; 
w if write permission is granted; 
a if alter permission is granted; 

- if the indicated permission is not granted. 

OWNER (all) The login name of the owner of the facility entry. 

GROUP (all) The group name of the group of the owner of the facility entry. 

CREATOR (a,c) The login name of the creator of the facility entry. 

CGROUP (a,c) The group name of the group of the creator of the facility entry. 

CBYTES (a,o) The number of bytes in messages currently outstanding on the associated message 

queue. 

QNUM (a,o) The number of messages currently outstanding on the associated message queue. 

QBYTES (a,b) The maximum number of bytes allowed in messages outstanding on the associated 

message queue. 

LSPID (a,p) The process ID of the last process to send a message to the associated queue. 

LRPID (a,p) The process ID of the last process to receive a message from the associated queue. 

STIME (a,t) The time the last message was sent to the associated queue. 

RTIME (a,t) The time the last message was received from the associated queue. 

CTIME (a,t) The time when the associated entry was created or changed. 

NATTCH (a,o) The number of processes attached to the associated shared memory segment. 

SEGSZ (a,b) The size of the associated shared memory segment. 

CPID (a,p) The process ID of the creator of the shared memory entry. 

LPID (a,p) The process ID of the last process to attach or detach the shared memory segment. 

ATIME (a,t) The time the last attach was completed to the associated shared memory segment. 

DTIME (a,t) The time the last detach was completed on the associated shared memory segment. 

NSEMS (a,b) The number of semaphores in the set associated with the semaphore entry. 

OTIME (a,t) The time the last semaphore operation was completed on the set associated with the 
semaphore entry. 

FILES 

/unix system namelist 

/dev/kmem memory 
/etc/passwd user names 
/etc/group group names 

SEE ALSO 

msgop(2), semop(2), shmop(2). 

BUGS 

Things can change while ipcs is running; the picture it gives is only a close approximation to reality. 
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NAME 

join - relational database operator 
SYNOPSIS 

join [ options ] file 1 file2 

DESCRIPTION 

Join forms, on the standard output, a join of the two relations specified by the lines of file 1 and file2. If 
file I is -, the standard input is used. 

Filel and file2 must be sorted in increasing ASCII collating sequence on the fields on which they are to be 
joined, normally the first in each line. 

There is one line in the output for each pair of lines in filel and file2 that have identical join fields. The 
output line normally consists of the common field, then the rest of the line from filel , then the rest of the 
line from Jile2. 

Fields are normally separated by blank, tab or new-line. In this case, multiple separators count as one, and 
leading separators are discarded. 

These options are recognized: 

-an In addition to the normal output, produce a line for each unpairable line in file n, where n is 1 or 2. 
-e ,v Replace empty output fields by string s. 

-j n m Join on the mth field of file n . If n is missing, use the mth field in each file. 

-o list Each output line comprises the fields specifed in list, each element of which has the form n.m, 
where n is a file number and in is a field number. 

-tc Use character c as a separator (tab character). Every appearance of c in a line is significant. 

SEE ALSO 

awk(l), comm(l), sort(l). 

BUGS 

With default field separation, the collating sequence is that of sort -b; with -t, the sequence is that of a 
plain sort. 

The conventions of join , sort, comm, uniq and awk( 1) are wildly incongruous. 
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NAME 

kasb, kunb - assembler/un-assembler for the KMCl IB microprocessor 
SYNOPSIS 

kasb [ name ] [ -o name 1 ] [ -d name2 ] 
kunb [ name ] [ -o name 1 ] 

DESCRIPTION 

Kasb is an assembler/debugger/loader for the KMCl IB microprocessor. The optional argument name 
specifies the input file; default is standard input. The optional argument -o indicates that the next argument 
namel will be the output of the assembler; default is a.out. The optional argument -d indicates that the 
assembler is to be used in debug mode and that the next argument name2 is the device file name of the 
microprocessor. No output file is created in debug mode. 

Error diagnostics are written on the standard error output and contain the input file name and line number 
and a brief description of the error. C preprocessor control lines to change the file name and line number 
are recognized. This allows the use of the preprocessor to expand the input before assembly. 

Kunb is an un-assembler for the KMCll/DMCll microprocessor. It produces an output listing, acceptable 
to the assembler kasb , from the input object. 

The optional argument name specifies the input object, default is standard input. The format of the input is 
either assembler output (first word magic 0410), or formatted dump (first word magic 0440), or raw dump 
(anything else). In the first two cases, the header is ignored. 

The optional argument -o indicates that the next argument namel is to contain the output listing, default is 
standard output. 

The input object is first scanned to determine branch destinations. Labels will be inserted at these locations 
with format hint:, where int is the octal value of the location in words. Immediate values of instructions 
are also printed in octal. Page breaks are noted by the labels PO:,..., P3:. 

FILES 

a.out output object 

/dev/kmc? microprocessor device 

/lib/cpp C preprocessor 

SEE ALSO 

kmc(7), vpm(7). 

Assembler for the DEC KMCl 1 Microprocessor by L. A. Wehr. 
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NAME 

kill - terminate a process 

SYNOPSIS 

kill [ -signo ] PID ... 

DESCRIPTION 

Kill sends signal 15 (terminate) to the specified processes. This will normally kill processes that do not 
catch or ignore the signal. The process number of each asynchronous process started with & is reported by 
the Shell (unless more than one process is started in a pipeline, in which case the number of the last process 
in the pipeline is reported). Process numbers can also be found by using ps (\). 

The details of the kill are described in kill(2). For example, if process number 0 is specified, all processes 
in the process group are signaled. 

The killed process must belong to the current user unless he is the super-user. 

If a signal number preceded by - is given as first argument, that signal is sent instead of terminate (see 
signal ( 2)). In particular “kill -9 ...” is a sure kill. 

SEE ALSO 

ps(l), sh(l), kill(2), signal(2). 
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NAME 

Id - link editor for common object files 
SYNOPSIS 

Id [-e epsym] [-f fill] [-lx] [-m] [-r] [-s] [-0 outfile] [-u symname] [-L dir] [-x] [-N] [-V] [-VS num] 
file-names 

DESCRIPTION 

The Id command combines several object files into one, performs relocation, resolves external symbols, and 
supports symbol table information for symbolic debugging. In the simplest case, the names of several 
object programs are given, and Id combines them, producing an object module that can either be executed 
or used as input for a subsequent Id run. The output of Id is left in a.out. This file is executable if no errors 
occurred during the load. If any input fil &, file-name, is not an object file. Id assumes it is either an ASCII 
file containing link editor directives or an archive library. 

If any argument is a library, it is searched exactly once at the point it is encountered in the argument list. 
Only those routines defining an unresolved external reference are loaded. The library (archive) symbol 
table (see ar{A)) is searched sequentially with as many passes as are necessary to resolve external refer¬ 
ences which can be satisfied by library members. Thus, the ordering of library members is unimportant. 

The following options are recognized by Id. 

-e epsym 

Set the default entry point address for the output file to be that of the symbol epsym. 

-f fill This option sets the default fill pattern for “holes” within an output section as well as initialized 
bss sections. The argument^// is a two-byte constant. 

-Ly This option specifies a library named x. It stands for Iibx.a where x is up to seven characters. A 
library is searched when its name is encountered, so the placement of a -1 is significant. By 
default, libraries are located in /lib and /usr/lib. 

-m This option causes a map or listing of the input/output sections to be produced on the standard out¬ 
put. 

-o outfile 

This option produces an output object file by the name outfile. The name of the default object file 

is a.out. 

-r This option causes relocation entries to be retained in the output object file. Relocation entries 
must be saved if the output file is to become an input file in a subsequent Id run. The link editor 
will not complain about unresolved references. 

-s This option causes line number entries and symbol table information to be stripped from the out¬ 
put object file. 

-u symname 

Takes the argument symname as a symbol and enters it as undefined in the symbol table. This is 
useful for loading entirely from a library, since initially the symbol table is empty and an unre¬ 
solved reference is needed to force the loading of the first routine. 

-x Do not preserve local (non-.globl) symbols in the output symbol table; only enter external and 
static symbols. This option saves some space in the output file. 

-L dir Change the algorithm of searching for libx.a to look in dir before looking in /lib. 

-N Put the data section immediately following the text in the output file 

-V Output a message giving information about the version of Id being used. 

-VS num 

The num argument is taken as a decimal version number identifying the a.out file that is pro¬ 
duced. The version stamp is stored in the optional header. 
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FILES 

/lib/libx.a 
a.out 

SEE ALSO 

as( 1 ),cc( 1 ),a.out(4),ar(4) 

CAVEATS 

Through its input directives, the common link editor gives users great flexibility; however, people who use 
the input directives must assume some added responsibilities. Input directives should insure the following 
properties for programs: 

C defines a zero pointer as null. A pointer to which zero has been assigned must not point to any 
object. To satisfy this, users must not place any object at virtual address zero in the data space. 


libraries 
output file 
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NAME 

Id - link editor 
SYNOPSIS 

Id [ -sulxXrdnim ] [ -o name ] [ -t name ] [ -V num ] file ... 

DESCRIPTION 

Ld combines several object programs into one; resolves external references; and searches libraries (as cre¬ 
ated by ar{ 1)). In the simplest case several object files are given, and Id combines them, producing an 
object module which can be either executed or become the input for a further Id run. (In the latter case, the 
-r option must be given to preserve the relocation bits.) The output of Id is left on a.out. This file is made 
executable if no errors occurred during the load and the -r flag was not specified. 

The argument routines are concatenated in the order specified. The entry point of the output is the begin¬ 
ning of the first routine. 

If any argument is a library, it is searched exactly once at the point it is encountered in the argument list. 
Only those routines defining an unresolved external reference are loaded. If a routine from a library refer¬ 
ences another routine in the library, the referenced routine must appear after the referencing routine in the 
library. Thus the order of programs within libraries is important. 

The symbols etext, edata and end (etext, edata and end in C) are reserved, and if referred to, are set to 
the first location above the program, the first location above initialized data, and the first location above all 
data respectively. It is erroneous to define these symbols. 

Ld understands several flag arguments which are written preceded by a -. Except for -1, they should appear 
before the file names. 

-s “Strip” the output, that is, remove the symbol table and relocation bits to save space (but impair 
the usefulness of the debugger). This information can also be removed by strip(l). This option is 
turned off if there are any undefined symbols. 

-u Take the following argument as a symbol and enter it as undefined in the symbol table. This is 
useful for loading wholly from a library, since initially the symbol table is empty and an unre¬ 
solved reference is needed to force the loading of the first routine. 

-1 This option is an abbreviation for a library name. -1 alone stands for /lib/libc.a, which is the stan¬ 
dard system library for C and assembly language programs, -lx stands for /lib/libx.a, where x is a 
string. If that does not exist. Id tries /usr/lib/libv.a A library is searched when its name is encoun¬ 
tered, so the placement of a -1 is significant. 

-x Do not preserve local (non-.globl) symbols in the output symbol table; only enter external sym¬ 
bols. This option saves some space in the output file. 

-X Save local symbols except for those whose names begin with L. This option is used by cc to dis¬ 
card internally generated labels while retaining symbols local to routines. 

-r Generate relocation bits in the output file so that it can be the subject of another Id mn. This flag 
also prevents final definitions from being given to common symbols, and suppresses the 
‘ ‘undefined symbol'' diagnostics. 

-d Force definition of common storage even if the -r flag is present. 

-n Arrange that when the output file is executed, the text portion will be read-only and shared among 
all users executing the file. This involves moving the data areas up to the first possible 4K word 
boundary following the end of the text. Use -N to turn it off. 

-i When the output file is executed, the program text and data areas will live in separate address 
spaces. The only difference between this option and -n is that here the data starts at location 0. 

-m The names of all files and archive members used to create the output file are written to the standard 
output. 
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-o The name argument after -o is used as the name of the Id output file, instead of a.out. 

-t The name argument is taken to be a symbol name, and any references to or definitions of that sym¬ 

bol are listed, along with their types. There can be up to 16 occurrences of -t name on the com¬ 
mand line. 

-V The num argument is taken as a decimal version number identifying the a.out that is produced. 
Num must be in the range 0-32767. The version stamp is stored in the a.out header; see a.out(A). 

FILES 

/lib/lib?.a libraries 

/usr/lib/lib?.a more libraries 

a.out output file 

SEE ALSO 

ar(l), as(l), cc(l), a.out(4), ar(4). 
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NAME 

lex - generate programs for simple lexical tasks 
SYNOPSIS 

lex [ -rctvn ][ file ]... 

DESCRIPTION 

Lex generates programs to be used in simple lexical analysis of text. 

The input files (standard input default) contain strings and expressions to be searched for, and C text to be 
executed when strings are found. 

A file lex.yy.c is generated which, when loaded with the library, copies the input to the output except when 
a string specified in the file is found; then the corresponding program text is executed. The actual string 
matched is left in yytext, an external character array. Matching is done in order of the strings in the file. 
The strings may contain square brackets to indicate character classes, as in [abx-z] to indicate a, b, x, y, 
and z; and the operators *, +, and ? mean respectively any non-negative number of, any positive number 
of, and either zero or one occurrences of, the previous character or character class. The character . is the 
class of all ASCII characters except new-line. Parentheses for grouping and vertical bar for alternation are 
also supported. The notation r{d,e} in a rule indicates between d and e instances of regular expression r. 
It has higher precedence than I, but lower than *, ?, +, and concatenation. The character " at the beginning 
of an expression permits a successful match only immediately after a new-line, and the character $ at the 
end of an expression requires a trailing new-line. The character / in an expression indicates trailing context; 
only the part of the expression up to the slash is returned in yytext, but the remainder of the expression must 
follow in the input stream. An operator character may be used as an ordinary symbol if it is within " sym¬ 
bols or preceded by Y Thus [a-zA-Z]+ matches a string of letters. 

Three subroutines defined as macros are expected: input)) to read a character; unput(c) to replace a charac¬ 
ter read; and output(c) to place an output character. They are defined in terms of the standard streams, but 
you can override them. The program generated is named yylex(), and the library contains a main() which 
calls it. The action REJECT on the right side of the rule causes this match to be rejected and the next suit¬ 
able match executed; the function yymore() accumulates additional characters into the same yytext ; and the 
function yvless)/; ) pushes back the portion of the string matched beginning at p, which should be between 
yytext and yytext+yyleng. The macros input and output use files yyin and yyout to read from and write to, 
defaulted to stdin and stdout, respectively. 

Any line beginning with a blank is assumed to contain only C text and is copied; if it precedes % % it is 
copied into the external definition area of the lex.yy.c file. All rules should follow a %%, as in YACC. 
Lines preceding % % which begin with a non-blank character define the string on the left to be the remain¬ 
der of the line; it can be called out later by surrounding it with {}. Note that curly brackets do not imply 
parentheses; only string substitution is done. 

EXAMPLE 


D 

[0-9] 

%% 


if 

printf("IF statements"); 

[a-z]+ 

printf("tag, value %s\n",yytext); 

0{D}+ 

printf("octal number %s\n",yytext); 

{D}+ 

printf("decimal number %s\n",yytext); 

"++" 

printf("unary op\n"); 

ii | ii 

printf("binary op\n"); 


{ loop: 


while (input)) != '*'); 
switch (input))) 

{ 

case 7': break; 
case imput^*'); 
default: go to loop; 


Page 1 



LEX(l) 


LEX(l) 



The external names generated by lex all begin with the prefix yy or YY. 

The flags must appear before any files. The flag -r indicates RATFOR actions, -c indicates C actions and is 
the default, -t causes the lex.yy.c program to be written instead to standard output, -v provides a one-line 
summary of statistics of the machine generated, -n will not print out the - summary. Multiple files are 
treated as a single file. If no files are specified, standard input is used. 

Certain table sizes for the resulting finite state machine can be set in the definitions section: 

%p n number of positions is n (default 2000) 

%n n number of states is n (500) 

%t n number of parse tree nodes is n (1000) 

%a n number of transitions is n (3000) 

The use of one or more of the above automatically implies the -v option, unless the -n option is used. 


SEE ALSO 

yacc(l). 

LEX-Lexical Analyzer Generator by M. E. Lesk and E. Schmidt. 

BUGS 

The -r option is not yet fully operational. 
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NAME 

line - read one line 

SYNOPSIS 

line 

DESCRIPTION 

Line copies one line (up to a new-line) from the standard input and writes it on the standard output. It 
returns an exit code of 1 on EOF and always prints at least a new-line. It is often used within shell files to 
read from the user’s terminal. 

SEE ALSO 

sh(l), read(2). 
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NAME 

lint - a C program checker 
SYNOPSIS 

lint [ -abhlnpuvx ] file ... 

DESCRIPTION 

Lint attempts to detect features of the C program files which are likely to be bugs, non-portable, or waste¬ 
ful. It also checks type usage more sttictly than the compilers. Among the things which are currently 
detected are unreachable statements, loops not entered at the top, automatic variables declared and not used, 
and logical expressions whose value is constant. Moreover, the usage of functions is checked to find func¬ 
tions which return values in some places and not in others, functions called with varying numbers of argu¬ 
ments, and functions whose values are not used. 

It is assumed that all the files are to be loaded together; they are checked for mutual compatibility. By 
default, lint uses function definitions from the standard lint library llib-lc In; function definitions from the 
portable lint library llib-port In are used when lint is invoked with the -p option. 

Any number of lint options may be used, in any order. The following options are used to suppress certain 
kinds of complaints: 

-a Suppress complaints about assignments of long values to variables that are not long. 

-b Suppress complaints about break statements that cannot be reached. (Programs produced by lex 

or yacc will often result in a large number of such complaints.) 

-h Do not apply heuristic tests that attempt to intuit bugs, improve style, and reduce waste. 

-u Suppress complaints about functions and external variables used and not defined, or defined and 
not used. (This option is suitable for running lint on a subset of files of a larger program.) 

-v Suppress complaints about unused arguments in functions. 

-x Do not report variables referred to by external declarations but never used. 

The following arguments alter lint’s behavior: 

-Ly Include additional lint library llib-Lr.ln. You can include a lint version of the math library llib- 
lm.ln by inserting -lm on the command line. This argument does not suppress the default use of 
llib-lc.ln. This option can be used to keep local lint libraries and is useful in the development of 
multi-file projects. 

-n Do not check compatibility against either the standard or the portable lint library. 

-p Attempt to check portability to other dialects (IBM and GCOS) of C. 

The -D, -U, and -I options of cc(l) are also recognized as separate arguments. 

Certain conventional comments in the C source will change the behavior of lint: 

/* NOTREACHED*/ 

at appropriate points stops comments about unreachable code. 

/*VARARGSu */ 

suppresses the usual checking for variable numbers of arguments in the following func¬ 
tion declaration. The data types of the first n arguments are checked; a missing n is taken 
to be 0. 

/*ARGSUSED*/ 

turns on the -v option for the next function. 

/*LINTLIBRARY*/ 

at the beginning of a file shuts off complaints about unused functions in this file. 

Lint produces its first output on a per source file basis. Complaints regarding included files are collected 
and printed after all source files have been processed. Finally, information gathered from all input files is 
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collected and checked for consistency. At this point, if it is not clear whether a complaint stems from a 
given source file or from one of its included files, the source file name will be printed followed by a ques¬ 
tion mark. 

FILES 

/usr/lib/lint [12] programs 

/usr/lib/llib-lc.ln declarations for standard functions (binary format; source is in /usr/lib/llib-lc) 
/usr/lib/llib-port.ln declarations for portable functions (binary format; source is in /usr/lib/llib-port) 
/usr/lib/llib-lm.ln declarations for standard math functions (binary format; source is in /usr/lib/llib-lm) 
/usr/tmp/*lint* temporaries 

SEE ALSO 

cc(l). 

BUGS 

Exit(2) and other functions which do not return are not understood; this causes various lies. 
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NAME 

list - produce C source listing from 3B20S object file 
SYNOPSIS 

list [ -V ] [-h] source-file . . . [object-file] 

DESCRIPTION 

The list command produces a C source listing with line number information attached. If multiple C source 
files were used to create the object file, list will accept multiple file names. The object file is taken to be the 
last non-C source file argument. If no object file is specified the default object file, a.out, will be used. 

Line numbers will be printed for each breakpoint inserted by the compiler (generally, each executable C 
statement that begins a new line of source). Line numbering begins anew for each function. Line number 1 
is always the line containing the left curly brace ({) that begins the function body. Line numbers will also 
be supplied for inner block redeclarations of local variables so that they can be distinguished by the sym¬ 
bolic debugger. 

The -V flag will supply version information of the list command. 

The -h flag will suppress heading output. 

CAVEATS 

Object files given to list must have symbolic debugging symbols. 

Since list does not use the C preprocessor, it may be unable to recognize function definitions whose syntax 
has been distorted by the use of C preprocessor macro substitutions. 

SEE ALSO 

as(l), cc( 1), ld(l). 

DIAGNOSTICS 

“list: name: cannot open” if name cannot be read. 
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NAME 

login - sign on 
SYNOPSIS 

login [ name [ env-var ... ] ] 

DESCRIPTION 

The login command is used at the beginning of each terminal session and allows you to identify yourself to 
the system. It may be invoked as a command or by the system when a connection is first established. Also, 
it is invoked by the system when a previous user has terminated the initial shell by typing a cntrl-d to indi¬ 
cate an “end-of-file.” (See How to Get Started at the beginning of this volume for instructions on how to 
dial up initially.) 

If login is invoked as a command it must replace the initial command interpreter. This is accomplished by 
typing: 

exec login 

from the initial shell. 

Login asks for your user name (if not supplied as an argument), and, if appropriate, your password. Echo¬ 
ing is turned off (where possible) during the typing of your password, so it will not appear on the written 
record of the session. 

At some installations, an option may be invoked that will require you to enter a second “dialup” password. 
This will occur only for dial-up connections, and will be prompted by the message “dialup password:”. 
Both passwords are required for a successful login. 

If you do not complete the login successfully within a certain period of time (e.g., one minute), you are 
likely to be silently disconnected. 

After a successful login, accounting files are updated, the procedure /etc/profile is performed, the message - 
of-the-day, if any, is printed, the user-ID, the group-ID, the working directory, and the command interpreter 
(usually sh{ 1)) is initialized, and the file .profile in the working directory is excuted, if it exists. These 
specifications are found in the /etc/passwd file entry for the user. The name of the command interpreter is 
- followed by the last component of the interpreter’s pathname (i.e., -sh). If this field in the password file 
is empty, then the default command interpreter, /bin/sh is used. 

The basic environment (see environ (5)) is initialized to: 

HOME=y our-login-directory 

PATH=:/bin:/usr/bin 

SHELL =last-field-of-passwd-entry 

MA\L=/usr/m'd\\/your-login-name 

TZ=timez,one-specification 

The environment may be expanded or modified by supplying additional arguments to login, either at execu¬ 
tion time or when login requests your login name. The arguments may take either the form xxx or xxx=yyy. 
Arguments without an equal sign are placed in the environment as 
L«=xxx 

where n is a number starting at 0 and is incremented each time a new variable name is required. Variables 
containing an = are placed into the environment without modification. If they already appear in the envi¬ 
ronment, then they replace the older value. There are two exceptions. The variables PATH and SHELL 
cannot be changed. This prevents people, logging into restricted shell environments, from spawning sec¬ 
ondary shells which aren’t restricted. Both login and getty understand simple single character quoting con¬ 
ventions. Typing a backslash in front of a character quotes it and allows the inclusion of such things as 
spaces and tabs. 

FILES 

/etc/utmp accounting 

/etc/wtmp accounting 
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/usr/mail /your-name mailbox for user your-name 
/etc/motd message-of-the-day 

/etc/passwd password file 

/etc/profile system profile 

.profile user’s login profile 


SEE ALSO 

mail(l), newgrp(l), sh( 1), su(l), passwd(4), profile(4), environ(5). 


DIAGNOSTICS 

Login incorrect if the user name or the password cannot be matched. 

No shell, cannot open password file, or no directory, consult a UNIX System programming counselor. 

No utmp entry. You must exec "login" from the lowest level "sh". if you attempted to execute login as a 
command without using the shell’s exec internal command or from other than the initial shell. 
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NAME 

logname - get login name 

SYNOPSIS 

logname 

DESCRIPTION 

Logname returns the contents of the environment variable $LOGNAME, which is set when a user logs into 
the system. 

FILES 

/etc/profile 
SEE ALSO 

env(l), login(l), logname(3X), environ(5). 
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NAME 

lorder - find ordering relation for an object library 

SYNOPSIS 

lorder file ... 

DESCRIPTION 

The input is one or more object or library archive files (see ar( I)). The standard output is a list of pairs of 
object file names, meaning that the first file of the pair refers to external identifiers defined in the second. 
The output may be processed by tsorti I) to find an ordering of a library suitable for one-pass access by 
ld( 1). Note that the link editor (except on the PDP -11) ld( 1) is capable of multiple passes over an archive in 
the portable archive format (see ar( 4)) and does not require that lorder ( I) be used when building an 
archive. The usage of the lorder( 1) command may, however, allow for a slightly more efficient access of 
the archive during the link edit process. 

The following example builds a new library from existing .o files, 
ar cr library v lorder *.o I tsort v 

FILES 

*symref, *symdef temporary files 

SEE ALSO 

ar(l), ld(l), tsort(l), ar(4). 

BUGS 

Object files whose names do not end with .o, even when contained in library archives, are overlooked. 
Their global symbols and references are attributed to some other file. 
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NAME 

lp, cancel - send/cancel requests to an LP line printer 

SYNOPSIS 

lp [-c] [-ddest] [-m] [-nnumber] [-ooption] [-s] [—ttitle] [-w] files 
cancel [ ids ] [ printers ] 

DESCRIPTION 

Lp arranges for the named files and associated information (collectively called a request) to be printed by a 
line printer. If no file names are mentioned, the standard input is assumed. The file name - stands for the 
standard input and may be supplied on the command line in conjunction with named files. The order in 
which files appear is the same order in which they will be printed. 

Lp associates a unique id with each request and prints it on the standard output. This id can be used later to 
cancel (see cancel) or find the status (see Ipstat(l)) of the request. 

The following options to lp may appear in any order and may be intermixed with file names: 

-c Make copies of th e files to be printed immediately when Ip is invoked. Normally, files will not 

be copied, but will be linked whenever possible. If the -c option is not given, then the user 
should be careful not to remove any of the files before the request has been printed in its 
entirety. It should also be noted that in the absence of the -c option, any changes made to the 
named files after the request is made but before it is printed will be reflected in the printed out¬ 
put. 

-ddest Choose dest as the printer or class of printers that is to do the printing. If dest is a printer, then 
the request will be printed only on that specific printer. If dest is a class of printers, then the 
request will be printed on the first available printer that is a member of the class. Under certain 
conditions (printer unavailability, file space limitation, etc.), requests for specific destinations 
may not be accepted (see acceptfi\M) and Ipstati I)). By default, dest is taken from the environ¬ 
ment variable LPDEST (if it is set). Otherwise, a default destination (if one exists) for the com¬ 
puter system is used. Destination names vary between systems (see lpstat( 1)). 

-m Send mail (see mail(l)) after the files have been printed. By default, no mail is sent upon nor¬ 

mal completion of the print request. 

-n number Print number copies (default of 1) of the output. 

-o option Specify printer-dependent or class-dependent options. Several such options may be collected 

by specifying the -o keyletter more than once. For more information about what is valid for 
options, see Models in lpadmin( 1M). 

-s Suppress messages from lp{ 1) such as "request id is ...". 

-t title Print title on the banner page of the output. 

-w Write a message on the user’s terminal after th c files have been printed. If the user is not logged 

in, then mail will be sent instead. 

Cancel cancels line printer requests that were made by the lp( 1) command. The command line arguments 
may be either request ids (as returned by lp( I)) or printer names (for a complete list, use Ipstat(l)). Speci¬ 
fying a request id cancels the associated request even if it is currently printing. Specifying a printer cancels 
the request which is currently printing on that printer. In either case, the cancellation of a request that is 
currently printing frees the printer to print its next available request. 

FILES 

/usr/spool/lp/* 

SEE ALSO 

enable(l), lpstat(l), mail(l). 

accept(lM), lpadmin(lM), lpsched(lM) in the UNIX System Administrator’s Manual. 


Page 1 



LPR(l) 


(Obsolescent) 


LPR(l) 


NAME 

lpr - line printer spooler 
SYNOPSIS 

lpr [ option ... ] [ name ... ] 

DESCRIPTION 

Lpr causes the named files to be queued for printing on a line printer. If no names appear, the standard 
input is assumed; thus lpr may be used as a filter. 

The following options may be given (each as a separate argument and in any order) before any file name 
arguments: 

-c Makes a copy of the file to be sent before returning to the user. 

-r Removes the file after sending it. 

-m When printing is complete, reports that fact by mail( 1). 

-n Does not report the completion of printing by mail( 1). This is the default option. 

-f file \Jse file as a dummy file name to report back in the mail. (This is useful for distinguishing multi¬ 

ple runs, especially when lpr is being used as a filter). 

FILES 

/etc/passwd user’s identification and accounting data. 

/usr/lib/lpd line printer daemon. 

/usr/spool/lpd/* spool area. 

SEE ALSO 

dpd(lC), dpr(lC), lp(l). 
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NAME 

lpstat - print LP status information 

SYNOPSIS 

lpstat [ options ] 

DESCRIPTION 

Lpstat prints information about the current status of the LP line printer system. 

If no options are given, then lpstat prints the status of all requests made to lp(V) by the user. Any argu¬ 
ments that are not options are assumed to be request ids (as returned by Ip). Lpstat prints the status of such 
requests. Options may appear in any order and may be repeated and intermixed with other arguments. 
Some of the keyletters below may be followed by an optional list that can be in one of two forms: a list of 
items separated from one another by a comma, or a list of items enclosed in double quotes and separated 
from one another by a comma and/or one or more spaces. For example: 

-u"userl, user2, user3" 

The omission of a list following such keyletters causes all information relevant to the keyletter to be 
printed, for example: 

lpstat -o 

prints the status of all output requests. 

-a[ list ] Print acceptance status (with respect to Ip) of destinations for requests. List is a list of intermixed 
printer names and class names. 

—c[ list ] Print class names and their members. List is a list of class names. 

-d Print the system default destination for Ip. 

-o [list] Print the status of output requests. List is a list of intermixed printer names, class names, and 
request ids. 

-p[ list ] Print the status of printers. List is a list of printer names. 

-r Print the status of the LP request scheduler 

-s Print a status summary, including the status of the line printer scheduler, the system default desti¬ 

nation, a list of class names and their members, and a list of printers and their associated devices. 

-t Print all status information. 

—u[ list ] Print status of output requests for users. List is a list of login names. 

—v[ list] Print the names of printers and the pathnames of the devices associated with them. List is a list 
of printer names. 

FILES 

/usr/spool/lp/* 

SEE ALSO 

enable(l), lp( 1). 
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NAME 

Is - list contents of directories 
SYNOPSIS 

Is [ -logtasdrucifp ] names 
DESCRIPTION 

For each directory named. Is lists the contents of that directory; for each file named. Is repeats its name and 
any other information requested. By default, the output is sorted alphabetically. When no argument is 
given, the current directory is listed. When several arguments are given, the arguments are first sorted 
appropriately, but file arguments are processed before directories and their contents. There are several 
options: 

-1 List in long format, giving mode, number of links, owner, group, size in bytes, and time of last 
modification for each file (see below). If the file is a special file, the size field will contain the 
major and minor device numbers, rather than a size. 

-o The same as -1, except that the group is not printed. 

-g The same as -1, except that the owner is not printed. 

-t Sort by time of last modification (latest first) instead of by name. 

-a List all entries; in the absence of this option, entries whose names begin with a period (.) are not 

listed. 

-s Give size in blocks (including indirect blocks) for each entry. 

-d If argument is a directory, list only its name; often used with -1 to get the status of a directory. 

-r Reverse the order of sort to get reverse alphabetic or oldest first, as appropriate. 

-u Use time of last access instead of last modification for sorting (with the -t option) and/or printing 

(with the -1 option). 

-c Use time of last modification of the inode (mode, etc.) instead of last modification of the file for 
sorting (-t) and/or printing (-1). 

-i For each file, print the i-number in the first column of the report. 

-f Force each argument to be interpreted as a directory and list the name found in each slot. This 

option turns off -1, -t, -s, and -r, and turns on -a; the order is the order in which entries appear in 
the directory. 

-p Put a slash after each filename if that file is a directory. Especially useful for CRT terminals when 
combined with the pr( 1) command as follows: Is -p I pr -5 -t -w80. 

The mode printed under the -1 option consists of 11 characters that are interpreted as follows: 

The first character is: 

d if the entry is a directory; 
b if the entry is a block special file; 
c if the entry is a character special file; 
p if the entry is a fifo (a.k.a. “named pipe”) special file; 

- if the entry is an ordinary file. 

The next 9 characters are interpreted as three sets of three bits each. The first set refers to the 
owner’s permissions; the next to permissions of others in the user-group of the file; and the last to 
all others. Within each set, the three characters indicate permission to read, to write, and to exe¬ 
cute the file as a program, respectively. For a directory, “execute” permission is interpreted to 
mean permission to search the directory for a specified file. 

The permissions are indicated as follows: 
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r if the file is readable; 
w if the file is writable; 
x if the file is executable; 

- if the indicated permission is not granted. 

The group-execute permission character is given as s if the file has set-group-ID mode; likewise, 
the user-execute permission character is given as s if the file has set-user-ID mode. The last char¬ 
acter of the mode (normally x or -) is t if the 1000 (octal) bit of the mode is on; see chmod{ 1) for 
the meaning of this mode. The indications of set-ID and 1000 bit of the mode are capitalized ( S 
and T respectively) if the corresponding execute permission is not set. 

When the sizes of the files in a directory are listed, a total count of blocks, including indirect blocks, is 
printed. 

FILES 

/etc/passwd to get user IDs for Is -1 and Is -o. 

/etc/group to get group IDs for Is -1 and Is -g. 

SEE ALSO 

chmod(l), find(l). 
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NAME 

m4 - macro processor 

SYNOPSIS 

m4 [ options ] [ files ] 

DESCRIPTION 

M4 is a macro processor intended as a front end for Ratfor, C, and other languages. Each of the argument 
files is processed in order; if there are no files, or if a file name is the standard input is read. The pro¬ 
cessed text is written on the standard output. 

The options and their effects are as follows: 

-e Operate interactively. Interrupts are ignored and the output is unbuffered. Using this mode 
requires a special state of mind. 

-s Enable line sync output for the C preprocessor (#line ...) 

-B ini Change the size of the push-back and argument collection buffers from the default of 4,096. 

-Hint Change the size of the symbol table hash array from the default of 199. The size should be prime. 

-Sint Change the size of the call stack from the default of 100 slots. Macros take three slots, and non¬ 
macro arguments take one. 

-Tint Change the size of the token buffer from the default of 512 bytes. 

To be effective, these flags must appear before any file names and before any -D or -U flags: 

-D name [=val] 

Defines name to val or to null in val's absence. 

-U name 

undefines name. 

Macro calls have the form: 

name(argl,arg2,..., argn) 

The ( must immediately follow the name of the macro. If the name of a defined macro is not followed by a 
(, it is deemed to be a call of that macro with no arguments. Potential macro names consist of alphabetic 
letters, digits, and underscore , where the first character is not a digit. 

Leading unquoted blanks, tabs, and new-lines are ignored while collecting arguments. Left and right single 
quotes are used to quote strings. The value of a quoted string is the string stripped of the quotes. 

When a macro name is recognized, its arguments are collected by searching for a matching right parenthe¬ 
sis. If fewer arguments are supplied than are in the macro definition, the trailing arguments are taken to be 
null. Macro evaluation proceeds normally during the collection of the arguments, and any commas or right 
parentheses which happen to turn up within the value of a nested call are as effective as those in the original 
input text. After argument collection, the value of the macro is pushed back onto the input stream and res¬ 
canned. 

M4 makes available the following built-in macros. They may be redefined, but once this is done the origi¬ 
nal meaning is lost. Their values are null unless otherwise stated. 

define the second argument is installed as the value of the macro whose name is the first argument. 

Each occurrence of $n in the replacement text, where n is a digit, is replaced by the n-th 
argument. Argument 0 is the name of the macro; missing arguments are replaced by the null 
string; $# is replaced by the number of arguments; $* is replaced by a list of all the argu¬ 
ments separated by commas; $@ is like $*, but each argument is quoted (with the current 
quotes). 

undefine removes the definition of the macro named in its argument. 
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defn 

pushdef 

popdef 

ifdef 


shift 


changequote 

changecom 


divert 


undivert 


divnum 

dnl 

ifelse 


incr 

deer 

eval 


len 

index 

substr 


translit 


returns the quoted definition of its argument(s). It is useful for renaming macros, especially 
built-ins. 

like define, but saves any previous definition. 

removes current definition of its argument(s), exposing the previous one if any. 

if the first argument is defined, the value is the second argument, otherwise the third. If 
there is no third argument, the value is null. The word unix is predefined on the UNIX Sys¬ 
tem versions of m4. 

returns all but its first argument. The other arguments are quoted and pushed back with 
commas in between. The quoting nullifies the effect of the extra scan that will subsequently 
be performed. 

change quote symbols to the first and second arguments. The symbols may be up to five 
characters long. Changequote without arguments restores the original values (Le., ' '). 

change left and right comment markers from the default # and new-line. With no arguments, 
the comment mechanism is effectively disabled. With one argument, the left marker 
becomes the argument and the right marker becomes new-line. With two arguments, both 
markers are affected. Comment markers may be up to five characters long. 

m4 maintains 10 output streams, numbered 0-9. The final output is the concatenation of the 
streams in numerical order; initially stream 0 is the current stream. The divert macro 
changes the current output stream to its (digit-string) argument. Output diverted to a stream 
other than 0 through 9 is discarded. 

causes immediate output of text from diversions named as arguments, or all diversions if no 
argument. Text may be undiverted into another diversion. Undiverting discards the diverted 
text. 

returns the value of the current output stream. 

reads and discards characters up to and including the next new-line. 

has three or more arguments. If the first argument is the same string as the second, then the 
value is the third argument. If not, and if there are more than four arguments, the process is 
repeated with arguments 4, 5, 6 and 7. Otherwise, the value is either the fourth string, or, if 
it is not present, null. 

returns the value of its argument incremented by 1. The value of the argument is calculated 
by interpreting an initial digit-string as a decimal number. 

returns the value of its argument decremented by 1. 

evaluates its argument as an arithmetic expression, using 32-bit arithmetic. Operators 
include +, -, *, /, %, (exponentiation), bitwise &, I, ', and relational; parentheses. 
Octal and hex numbers may be specified as in C. The second argument specifies the radix 
for the result; the default is 10. The third argument may be used to specify the minimum 
number of digits in the result. 

returns the number of characters in its argument. 

returns the position in its first argument where the second argument begins (zero origin), or 
-1 if the second argument does not occur. 

returns a substring of its first argument. The second argument is a zero origin number select¬ 
ing the first character; the third argument indicates the length of the substring. A missing 
third argument is taken to be large enough to extend to the end of the first string. 

transliterates the characters in its first argument from the set given by the second argument to 
the set given by the third. No abbreviations are permitted. 
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include 

sinclude 

syscmd 

sysval 

maketemp 

m4exit 

m4wrap 

errprint 

dumpdef 

traceon 

traceoff 


returns the contents of the file named in the argument, 
is identical to include, except that it says nothing if the file is inaccessible, 
executes the UNIX System command given in the first argument. No value is returned, 
is the return code from the last call to syscmd. 

fills in a string of XXXXX in its argument with the current process ID. 
causes immediate exit from m4. Argument 1, if given, is the exit code; the default is 0. 
argument 1 will be pushed back at final EOF; example; m4wrapt' cleanup !)') 
prints its argument on the diagnostic output file. 

prints current names and definitions, for the named items, or for all if no arguments are 
given. 

with no arguments, turns on tracing for all macros (including built-ins). Otherwise, turns on 
tracing for named macros. 

turns off trace globally and for any macros specified. Macros specifically traced by traceon 
can be untraced only by specific calls to traceoff. 


SEE ALSO 

cc(l), cpp(l). The M4 Macro Processor by B. W. Kernighan and D. M. Ritchie. 
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NAME 

pdpl 1, u3b, vax - provide truth value about your processor type 

SYNOPSIS 

pdpll 

u3b 

vax 

DESCRIPTION 

The following commands will return a true value (exit code of 0) if you are on a processor that the com¬ 
mand name indicates. 

pdpll True if you are on a PDP-11/45 or PDP-11/70. 

u3b True if you are on a 3B20S. 

vax True if you are on a VAX-11/750 or VAX-11/780. 

The commands that do not apply will return a false (non-zero) value. These commands are often used 
within make ( 1) makefiles and shell procedures to increase portability. 

SEE ALSO 

sh( 1), test(l), true(l). 
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NAME 

mail, rmail - send mail to users or read mail 
SYNOPSIS 

mail [ -epqr ] [ -f file ] 
mail [ -t ] persons 
rmail [ -t ] persons 
DESCRIPTION 

Mail without arguments prints a user’s mail, message-by-message, in last-in, first-out order. For each mes¬ 
sage, the user is prompted with a ?, and a line is read from the standard input to determine the disposition of 
the message: 

<new-line> Go on to next message. 

+ Same as <new-line>. 

d Delete message and go on to next message, 

p Print message again. 

- Go back to previous message, 

s [files ] Save message in the named files (rnbox is default), 

w [files ] Save message, without its header, in the named files (rnbox is default), 

m [ persons ] Mail the message to the named persons (yourself is default), 

q Put undeleted mail back in the mailfile and stop. 

EOT (control-d) Same as q. 

x Put all mail back in the mailfile unchanged and stop. 

! command Escape to the shell to do command. 

* Print a command summary. 

The optional arguments alter the printing of the mail: 

-e causes mail not to be printed. An exit value of 0 is returned if the user has mail; otherwise, an exit 
value of 1 is returned. 

-p causes all mail to be printed without prompting for disposition. 

-q causes mail to terminate after interrupts. Normally an interrupt only causes the termination of the 
message being printed. 

-r causes messages to be printed in first-in, first-out order. 

-f file causes mail to use file (e.g., mbox) instead of the default mailfile. 

When persons are named, mail takes the standard input up to an end-of-file (or up to a line consisting of 
just a .) and adds it to each person's mailfile. The message is preceded by the sender’s name and a post¬ 
mark. Lines that look like postmarks in the message, (i.e., “From ...”) are preceded with a >. The -t 
option causes the message to be preceded by all persons the mail is sent to. A person is usually a user 
name recognized by login { I). If a person being sent mail is not recognized, or if mail is interrupted during 
input, the file dead.letter will be saved to allow editing and resending. 

To denote a recipient on a remote system, prefix person by the system name and exclamation mark (see 
uucp( 1C)). Everything after the first exclamation mark in persons is interpreted by the remote system. In 
particular, if persons contains additional exclamation marks, it can denote a sequence of machines through 
which the message is to be sent on the way to its ultimate destination. For example, specifying alblcde as a 
recipient’s name causes the message to be sent to user b!cde on system a. System a will interpret that des¬ 
tination as a request to send the message to user cde on system b. This might be useful, for instance, if the 
sending system can access system a but not system b, and system a has access to system b. 

The mailfile may be manipulated in two ways to alter the function of mail. The other permissions of the 
file may be read-write, read-only, or neither read nor write to allow different levels of privacy. If changed 
to other than the default, the file will be preserved even when empty to perpetuate the desired permissions. 
The file may also contain the first line: 
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Forward to person 

which will cause all mail sent to the owner of the mailfile to be forwarded to person. This is especially 
useful to forward all of a person’s mail to one machine in a multiple machine environment. 


Rmail only permits the sending of mail; uucp(\ C ) uses rmail as a security precaution. 


When a user logs in, the presence of mail, if any, is indicated. Also, notification is made if new mail arrives 
while using mail. 


FILES 

/etc/passwd 

/usr/mail /user 

$HOME/mbox 

$MAIL 

/tmp/ma* 

/usr/mail/*.lock 

dead.letter 


to identify sender and locate persons 
incoming mail for user, i.e., the mailfile 
saved mail 

variable containing path name of mailfile 
temporary file 
lock for mail directory 
unmailable text 


SEE ALSO 

login(l), uucp(lC), write(l). 

BUGS 

Race conditions sometimes result in a failure to remove a lock file. 

After an interrupt, the next message may not be printed; printing may be forced by typing a p. 
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NAME 

make - maintain, update, and regenerate groups of programs 
SYNOPSIS 

make [-f makefile] [-p] [-i] [— k] [-s] [—r] [-n] [-b] [—e] [-m] [-t] [-d] [—q] [ names ] 

DESCRIPTION 

The following is a brief description of all options and some special names: 

-f makefile Description file name. Makefile is assumed to be the name of a description file. A file name of 
- denotes the standard input. The contents of makefile override the built-in rules if they are 
present. 

-p Print out the complete set of macro definitions and target descriptions. 

-i Ignore error codes returned by invoked commands. This mode is entered if the fake target 

name .IGNORE appears in the description file. 

-k Abandon work on the current entry, but continue on other branches that do not depend on that 

entry. 

-s Silent mode. Do not print command lines before executing. This mode is also entered if the 

fake target name .SILENT appears in the description file. 

-r Do not use the built-in rules. 

-n No execute mode. Print commands, but do not execute them. Even lines beginning with an @ 

are printed. 

-b Compatibility mode for old makefiles. 

-e Environment variables override assignments within makefiles. 

-m Print a memory map showing text, data, and stack. This option is a no-operation on systems 

without the getu system call. 

-t Touch the target files (causing them to be up-to-date) rather than issue the usual commands. 

-d Debug mode. Print out detailed information on files and times examined. 

-q Question. The make command returns a zero or non-zero status code depending on whether 

the target file is or is not up-to-date. 

.DEFAULT If a file must be made but there are no explicit commands or relevant built-in rules, the com¬ 
mands associated with the name .DEFAULT are used if it exists. 

.PRECIOUS 

Dependents of this target will not be removed when quit or interrupt are hit. 

.SILENT Same effect as the -s option. 

.IGNORE Same effect as the -i option. 

Make executes commands in makefile to update one or more target names. Name is typically a program. If 
no -f option is present, makefile. Makefile, s makefile, and s.Makefile are tried in order. If makefile is -, 
the standard input is taken. More than one - makefile argument pair may appear. 

Make updates a target only if it depends on files that are newer than the target. All prerequisite files of a 
target are added recursively to the list of targets. Missing files are deemed to be out of date. 

Makefile contains a sequence of entries that specify dependencies. The first line of an entry is a blank- 
separated, non-null list of targets, then a :, then a (possibly null) list of prerequisite files or dependencies. 
Text following a ; and all following lines that begin with a tab are shell commands to be executed to update 
the target. The first line that does not begin with a tab or # begins a new dependency or macro definition. 
Shell commands may be continued across lines with the <backslashxnew-line> sequence. Everything 
printed by make (except the initial tab) is passed directly to the shell as is. Thus, 
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echo a\ 
b 

will produce 
ab 

exactly the same as the shell would. 

Sharp (#) and new-line surround comments. 

The following makefile says that pgm depends on two files a.o and b.o, and that they in turn depend on 
their corresponding source files (a.c and b.c) and a common file incl.h: 

pgm: a.o b.o 

cc a.o b.o -o pgm 

a. o: incl.h a.c 

cc -c a.c 

b. o: incl.h b.c 

cc -c b.c 

Command lines are executed one at a time, each by its own shell. The first one or two characters in a com¬ 
mand can be the following: or If @ is present, printing of the command is suppressed. If - 

is present, make ignores an error. A line is printed when it is executed unless the -s option is present, or 
the entry .SILENT: is in makefile , or unless the initial character sequence contains a @. The -n option 
specifies printing without execution; however, if the command line has the string $(MAKE) in it, the line is 
always executed (see discussion of the MAKEFLAGS macro under Environment). The -t (touch) option 
updates the modified date of a file without executing any commands. 

Commands returning non-zero status normally terminate make. If the -i option is present, or the entry 
.IGNORE: appears in makefile , or the initial character sequence of the command contains -. the error is 
ignored. If the -k option is present, work is abandoned on the current entry, but continues on other 
branches that do not depend on that entry. 

The -b option allows old makefiles (those written for the old version of make ) to run without errors. The 
difference between the old version of make and this version is that this version requires all dependency 
lines to have a (possibly null or implicit) command associated with them. The previous version of make 
assumed if no command was specified explicitly that the command was null. 

Interrupt and quit cause the target to be deleted unless the target is a dependency of the special name .PRE¬ 
CIOUS. 

Environment 

The environment is read by make. All variables are assumed to be macro definitions and processed as such. 
The environment variables are processed before any makefile and after the internal rules; thus, macro 
assignments in a makefile override environment variables. The -e option causes the environment to over¬ 
ride the macro assignments in a makefile. 

The MAKEFLAGS environment variable is processed by make as containing any legal input option (except 
-f, -p, and -d) defined for the command line. Further, upon invocation, make ‘ ‘invents’' the variable if it 
is not in the environment, puts the current options into it, and passes it on to invocations of commands. 
Thus, MAKEFLAGS always contains the current input options. This proves very useful for “super¬ 
makes’ ’. In fact, as noted above, when the -n option is used, the command $(MAKE) is executed anyway; 
hence, one can perform a make -n recursively on a whole software system to see what would have been 
executed. This is because the -n is put in MAKEFLAGS and passed to further invocations of $(MAKE). 
This is one way of debugging all of the makefiles for a software project without actually doing anything. 

Macros 

Entries of the form string1 = string2 are macro definitions. String2 is defined as all characters up to a com¬ 
ment character or an unescaped newline. Subsequent appearances of %{stringl [:substl=[subst2]]) are 
replaced by string2. The parentheses are optional if a single character macro name is used and there is no 
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substitute sequence. The optional :substl=subst2 is a substitute sequence. If it is specified, all non¬ 
overlapping occurrences of substl in the named macro are replaced by subst2. Strings (for the purposes of 
this type of substitution) are delimited by blanks, tabs, new-line characters, and beginnings of lines. An 
example of the use of the substitute sequence is shown under Libraries. 

Internal Macros 

There are five internally maintained macros which are useful for writing rules for building targets. 

$* The macro $* stands for the file name part of the current dependent with the suffix deleted. It is eval¬ 
uated only for inference rules. 

$@ The $@ macro stands for the full target name of the current target. It is evaluated only for explicitly 
named dependencies. 

$< The $< macro is only evaluated for inference rules or the .DEFAULT rule. It is the module which is 
out of date with respect to the target (i.e., the “manufactured” dependent file name). Thus, in the 
.c.o rule, the $< macro would evaluate to the .c file. An example for making optimized .o files from 
.c files is: 

.c.o: 

cc -c -O $*.c 
or: 

.c.o: 

cc -c -O $< 

$? The $? macro is evaluated when explicit rules from the makefile are evaluated. It is the list of prereq¬ 
uisites that are out of date with respect to the target; essentially, those modules which must be rebuilt. 

$% The $% macro is only evaluated when the target is an archive library member of the form lib(file.o). 
In this case, $@ evaluates to lib and $% evaluates to the library member, file.o. 

Four of the five macros can have alternative forms. When an upper case D or F is appended to any of the 
four macros the meaning is changed to “directory part” for D and “file part” for F. Thus, $(@D) refers to 
the directory part of the string $@. If there is no directory part, ./ is generated. The only macro excluded 
from this alternative form is $?. The reasons for this are debatable. 

Suffixes 

Certain names (for instance, those ending with ,o) have inferable prerequisites such as .c, .s, etc. If no 
update commands for such a file appear in makefile , and if an inferable prerequisite exists, that prerequisite 
is compiled to make the target. In this case, make has inference rules which allow building files from other 
files by examining the suffixes and determining an appropriate inference rule to use. The current default 
inference rules are: 

.c ,c~ .sh .sh~ .c.o .c~.o .c'.c .s.o .s~.o .y.o .y'.o .l.o .l'.o 
.y.c .y~.c .l.c .c.a .c~.a .s~.a .h'.h 

The internal rules for make are contained in the source file rules.c for the make program. These rules can 
be locally modified. To print out the rules compiled into the make on any machine in a form suitable for 
recompilation, the following command is used: 

make -fp - 2>/dev/null </dev/null 

The only peculiarity in this output is the (null) string which printf(3 S) prints when handed a null string. 

A tilde in the above rules refers to an SCCS file (see sccsfile( 4)). Thus, the rule .c~.o would transform an 
SCCS C source file into an object file (.o). Because the s. of the SCCS files is a prefix it is incompatible with 
make' s suffix point-of-view. Hence, the tilde is a way of changing any file reference into an SCCS file ref¬ 
erence. 

A rule with only one suffix (i.e. .c:) is the definition of how to build x from x.c. In effect, the other suffix is 
null. This is useful for building targets from only one source file (e.g., shell procedures, simple C pro¬ 
grams). 
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Additional suffixes are given as the dependency list for .SUFFIXES. Order is significant; the first possible 
name for which both a file and a rule exist is inferred as a prerequisite. The default list is: 

.SUFFIXES: .o .c .y .1 .s 

Here again, the above command for printing the internal rules will display the list of suffixes implemented 
on the current machine. Multiple suffix lists accumulate; .SUFFIXES: with no dependencies clears the list 
of suffixes. 

Inference Rules 

The first example can be done more briefly: 

pgm: a.o b.o 

cc a.o b.o -o pgm 
a.o b.o: incl h 

This is because make has a set of internal rules for building files. The user may add rules to this list by sim¬ 
ply putting them in the makefile. 

Certain macros are used by the default inference rules to permit the inclusion of optional matter in any 
resulting commands. For example, CFFAGS, FFFAGS, and YFFAGS are used for compiler options to 
cc(l), lex( 1), and yacc( 1) respectively. Again, the previous method for examining the current rules is rec¬ 
ommended. 

The inference of prerequisites can be controlled. The rule to create a file with suffix .o from a file with 
suffix .c is specified as an entry with .c.o: as the target and no dependents. Shell commands associated with 
the target define the rule for making a .o file from a .c file. Any target that has no slashes in it and starts 
with a dot is identified as a rule and not a true target. 

Fibraries 

If a target or dependency name contains parenthesis, it is assumed to be an archive library, the string within 
parenthesis referring to a member within the library. Thus lib(file.o) and $(FIB)(file.o) both refer to an 
archive library which contains file.o. (This assumes the FIB macro has been previously defined.) The 
expression $(FIB)(filel.o file2.o) is not legal. Rules pertaining to archive libraries have the form .XX.a 
where the XX is the suffix from which the archive member is to be made. An unfortunate byproduct of the 
current implementation requires the XX to be different from the suffix of the archive member. Thus, one 
cannot have lib(file.o) depend upon file.o explicitly. The most common use of the archive interface fol¬ 
lows. Here, we assume the source files are all C type source: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

@echo lib is now up to date 

.c.a: 

$(CC) -c $(CFLAGS) $< 
ar rv $@ $*.o 
rm -f $*.o 

In fact, the .c.a rule listed above is built into make and is unnecessary in this example. A more interesting, 
but more limited example of an archive library maintenance construction follows: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

$(CC) -c $(CFLAGS) $(?:.o=.c) 
ar rv lib $? 

rm $? @echo lib is now up to date 

.c.a:; 

Here the substitution mode of the macro expansions is used. The $? list is defined to be the set of object 
file names (inside lib) whose C source files are out of date. The substitution mode translates the .o to .c. 
(Unfortunately, one cannot as yet transform to .c~; however, this may become possible in the future.) Note 
also, the disabling of the .c.a: rule, which would have created each object file, one by one. This particular 
construct speeds up archive library maintenance considerably. This type of construct becomes very cum¬ 
bersome if the archive library contains a mix of assembly programs and C programs. 
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FILES 

[Mm]akefile and s.[Mm]akefile 

SEE ALSO 

sh(l). 

Make-A Program for Maintaining Computer Programs by S. I. Feldman. 

An Augmented Version of Make by E. G. Bradford. 

BUGS 

Some commands return non-zero status inappropriately; use -i to overcome the difficulty. Commands that 
are directly executed by the shell, notably cd( 1), are ineffectual across new-lines in make. The syntax 

(lib(filel.o file2.o file3.o) is illegal. You cannot build lib(file.o) from file.o. The macro $(a:.o=.c~) doesn't 
work. 
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NAME 

makekey - generate encryption key 

SYNOPSIS 

/usr/lib/makekey 

DESCRIPTION 

Makekey improves the usefulness of encryption schemes depending on a key by increasing the amount of 
time required to search the key space. It reads 10 bytes from its standard input, and writes 13 bytes on its 
standard output. The output depends on the input in a way intended to be difficult to compute (i.e., to 
require a substantial fraction of a second). 

The first eight input bytes (the input key ) can be arbitrary ASCII characters. The last two (the salt) are best 
chosen from the set of digits, ., /, and upper- and lower-case letters. The salt characters are repeated as the 
first two characters of the output. The remaining 11 output characters are chosen from the same set as the 
salt and constitute the output key. 

The transformation performed is essentially the following: the salt is used to select one of 4,096 crypto¬ 
graphic machines all based on the National Bureau of Standards DES algorithm, but broken in 4,096 differ¬ 
ent ways. Using the input key as key, a constant string is fed into the machine and recirculated a number of 
times. The 64 bits that come out are distributed into the 66 output key bits in the result. 

Makekey is intended for programs that perform encryption (e.g., ed( 1) and crypti I)). Usually, its input and 
output will be pipes. 

SEE ALSO 

crypt(l), ed(l), passwd(4). 
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NAME 

man, manprog - print entries in this manual 
SYNOPSIS 

man [ options ] [ section ] titles 

/usr/lib/manprog file 
DESCRIPTION 

Man locates and prints the entry of this manual named title in the specified section. (For historical reasons, 
the word “page” is often used as a synonym for “entry” in this context.) The title is entered in lower 
case. The section number may not have a letter suffix. If no section is specified, the whole manual is 
searched for title and all occurrences of it are printed. Options and their meanings are: 

-t Typeset the entry in the default format (8.5"xl 1"). 

-s Typeset the entry in the small format (6"x9"). 

-T4014 Display the typeset output on a Tektronix 4014 terminal using fc(l). 

-Ttek Same as -T4014. 

-Tst Print the typeset output on the MHCC STARE facility (this option is not usable on most sys¬ 

tems). 

-Tvp Print the typeset output on a Versatec printer; this option is not available at all UNIX System 

sites. 

-T term Format the entry using nroff and print it on the standard output (usually, the terminal); term is 
the terminal type (see term( 5) and the explanation below); for a list of recognized values of 
term, type help term2. The default value of term is 450. 

-w Print on the standard output only the path names of the entries, relative to /usr/man, or to the 

current directory for -d option. 

-d Search the current directory rather than /usr/man; requires the full file name (e.g., cu.lc, 

rather than just cu). 

-12 Indicates that the manual entry is to be produced in 12-pitch. May be used when $TERM (see 

below) is set to one of 300, 300s, 450, and 1620. (The pitch switch on the DASI 300 and 300s 
terminals must be manually set to 12 if this option is used.) 

-c Causes man to invoke col( I); note that col( 1) is invoked automatically by man unless term is 

one of 300, 300s, 450, 37, 4000a, 382, 4014, tek, 1620, and X. 

-y Causes man to use the non-compacted version of the macros. 

The above options other than -d, -c, and -y are mutually exclusive, except that the -s option may be used 
in conjunction with the first four -T options above. Any other options are passed to troff, nroff, or the 
man (5) macro package. 

When using nroff, man examines the environment variable $TERM (see environ{ 5)) and attempts to select 
options to nroff, as well as filters, that adapt the output to the terminal being used. The -T term option 
overrides the value of $TERM; in particular, one should use -Tip when sending the output of man to a line 
printer. 

Section may be changed before each title. 

As an example: 

man man 

would reproduce on the terminal this entry, as well as any other entries named man that may exist in other 
sections of the manual, e.g., man(5). 

If the first line of the input for an entry consists solely of the string: 

'V' x 

where x is any combination of the three characters c, e, and t, and where there is exactly one blank between 
the double quote (") and x, then man will preprocess its input through the appropriate combination of 
ch’(1), eqn( 1) (neqn for nroff) and thl( I), respectively; if eqn or neqn are invoked, they will automatically 
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read the file /usr/pub/eqnchar (see eqnchar( 5)). 

The man command executes manprog that takes a file name as its argument. Manprog calculates and 
returns a string of three register definitions used by the formatters identifying the date the file was last 
modified. The returned string has the form: 

-rdday -rm month -ry year 

and is passed to nrojf which sets this string as variables for the man macro package. Months are given 
from 0 to 11, therefore month is always 1 less than the actual month. The man macros calculate the correct 
month. If the man macro package is invoked as an option to nroff/troff (i.e., nrojf -man file), then the cur¬ 
rent day/month/year is used as the printed date. 

FILES 

/usr/man/u_man/man[l-6]/* the UNIX System User’s Manual 
/usr/man/a_man/man[178]/* the UNIX System Administator’s Manual 
/usr/man/local/man[l-8]/* local additions 

/usr/lib/manprog calculates modification dates of entries 

SEE ALSO 

cw(l), eqn(l), nroffi l), tbl(l), tc(l), troffi l), environ(5), man(5), term(5). 

BUGS 

All entries are supposed to be reproducible either on a typesetter or on a terminal. However, on a terminal 
some information is necessarily lost. 

Pages bearing the same name in both manuals will result in the UNIX System Administrator’s Manual entry 
being printed first, if no section argument is supplied. 
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NAME 

mesg - permit or deny messages 

SYNOPSIS 

mesg [ n ] [ y ] 

DESCRIPTION 

Mesg with argument n forbids messages via write{ 1) by revoking non-user write permission on the user’s 
terminal. Mesg with argument y reinstates permission. All by itself, mesg reports the current state without 
changing it. 

FILES 

/dev/tty* 

SEE ALSO 

write(l). 

DIAGNOSTICS 

Exit status is 0 if messages are receivable, 1 if not, 2 on error. 
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NAME 

nikdir - make a directory 

SYNOPSIS 

mkdir dimame ... 

DESCRIPTION 

Mkdir creates specified directories in mode 777 (possibly altered by umask( 1)). Standard entries, for the 
directory itself, and ... for its parent, are made automatically. 

Mkdir requires write permission in the parent directory. 

SEE ALSO 

sh(l), rm(l), umask(l). 

DIAGNOSTICS 

Mkdir returns exit code 0 if all directories were successfully made; otherwise, it prints a diagnostic and 
returns non-zero. 
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NAME 

mm, osdd, checkmm - print/check documents formatted with the MM macros 
SYNOPSIS 

mm [ options ] [ files ] 
osdd [ options ] [ files ] 
checkmm [ files ] 

DESCRIPTION 

Mm can be used to type out documents using nroff and the MM text-formatting macro package. It has 
options to specify preprocessing by tbl( 1) and/or neqn (see eqn( 1)) and postprocessing by various 
terminal-oriented output filters. The proper pipelines and the required arguments and flags for nroff and 
MM are generated, depending on the options selected. 

Osdd is equivalent to the command mm -mosd. For more information about the OSDD adapter macro 
package, see mosd(5). 

Options for mm are given below. Any other arguments or flags (e.g., -rC3) are passed to nroff or to MM, 
as appropriate. Such options can occur in any order, but they must appear before the files arguments. If no 
arguments are given, mm prints a list of its options. 

-T term Specifies the type of output terminal; for a list of recognized values for term , type help term2. 

If this option is not used, mm will use the value of the shell variable $TERM from the environ¬ 

ment (see profile (A) and environ (5)) as the value of term, if $TERM is set; otherwise, mm will 
use 450 as the value of term. If several terminal types are specified, the last one takes prece¬ 
dence. 

-12 Indicates that the document is to be produced in 12-pitch. May be used when $TERM is set to 

one of 300, 300s, 450, and 1620. (The pitch switch on the DASI 300 and 300s terminals must be 
manually set to 12 if this option is used.) 

-c Causes mm to invoke col{ 1); note that col( I) is invoked automatically by mm unless term is one 

of 300, 300s, 450, 37, 4000a, 382, 4014, tek, 1620, and X. 

-e Causes mm to invoke neqn ; also causes neqn to read the /usr/pub/eqnchar file (see 

eqnchari 5)). 

-t Causes mm to invoke tbl( I). 

-E Invokes the -e option of nroff. 

-y Causes mm to use the non-compacted version of the macros (see mm( 5)). 

As an example (assuming that the shell variable $TERM is set in the environment to 450), the two com¬ 
mand lines below are equivalent: 

mm -t -rC3 -12 ghh* 

tbl ghh* I nroff -cm -T450-12 -h -rC3 

Mm reads the standard input when - is specified instead of any file names. (Mentioning other files together 
with - leads to disaster.) This option allows mm to be used as a filter, e.g.: 

cat dws I mm - 

Checkmm is a program for checking the contents of the named files for errors in the use of the Memoran¬ 
dum Macros, missing or unbalanced neqn delimiters, and .EQ/.EN pairs. Note: The user need not use the 
checkeq program (see eqn( 1)). Appropriate messages are produced. The program skips all directories, and 
if no file name is given, standard input is read. 

HINTS 

1. Mm invokes nroff with the -h flag. With this flag, nroff assumes that the terminal has tabs set 
every 8 character positions. 

2. Use the -o list option of nroff to specify ranges of pages to be output. Note, however, that mm, if 
invoked with one or more of the -e, -t, and - options, together with the -o list option of nroff may 
cause a harmless “broken pipe” diagnostic if the last page of the document is not specified in list. 
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3. If you use the -s option of nroff (to stop between pages of output), use line-feed (rather than return 
or new-line) to restart the output. The -s option of nroff does not work with the -c option of mm, 
or if mm automatically invokes col( 1) (see -c option above). 

4. If you lie to mm about the kind of terminal its output will be printed on, you’ll get (often subtle) 
garbage; however, if you are redirecting output into a file, use the -T37 option, and then use the 
appropriate terminal filter when you actually print that file. 

SEE ALSO 

col(l), cw(l), env(l), eqn(l), greek(l), mmt(l), nroff(l), tbl(l), profiled), mm(5), mosd(5), term(5). 

UNIX System Document Processing Guide. 

DIAGNOSTICS 

mm “mm: no input file” if none of the arguments is a readable file and mm is not used as a filter. 

checkmm “Cannot open filename” if file(s) is unreadable. The remaining output of the program is diag¬ 
nostic of the source file. 
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NAME 

mmt, mvt - typeset documents, view graphs, and slides 
SYNOPSIS 

mmt [ options ] [ files ] 
mvt [ options ] [ files ] 

DESCRIPTION 

These two commands are very similar to mm( 1), except that they both typeset their input via troff( I), as 
opposed to formatting it via nroff\ mmt uses the MM macro package, while mvt uses the Macro Package for 
View Graphs and Slides. These two commands have options to specify preprocessing by tbl( 1) and/or 
eqn(l). The proper pipelines and the required arguments and flags for troff(l) and for the macro packages 
are generated, depending on the options selected. 

Options are given below. Any other arguments or flags (e.g., -rC3) are passed to troff(l) or to the macro 
package, as appropriate. Such options can occur in any order, but they must appear before the files argu¬ 
ments. If no arguments are given, these commands print a list of their options. 

-e Causes these commands to invoke eqn( 1); also causes eqn to read the /usr/pub/eqnchar file 

(see eqnchari 5)). 

-t Causes these commands to invoke tbl( 1). 

-Tst Directs the output to the MH STARE facility. 

-Tvp Directs the output to a Versatec printer; this option is not available at all UNIX System sites. 
-T4014 Directs the output to a Tektronix 4014 terminal via the fc(l) filter. 

-Ttek Same as -T4014. 

-a Invokes the -a option of troff( 1). 

-y Causes mmt to use the non-compacted version of the macros (see mm( 5)). No effect for mvt. 

These commands read the standard input when - is specified instead of any file names. 

Mvt is just a link to mmt. 

HINT 

Use the -o list option of troff(l) to specify ranges of pages to be output. Note, however, that these com¬ 
mands, if invoked with one or more of the -e, -t, and - options, together with the -o list option of troffi 1) 
may cause a harmless “broken pipe” diagnostic if the last page of the document is not specified in list. 

SEE ALSO 

env(l), eqn(l), mm(l), tbl(l), tc(l), troffd), profile(4), environ(5), mm(5), mv(5). 

UNIX System Document Processing Guide. 

DIAGNOSTICS 

“m[mv]t: no input file” if none of the arguments is a readable file and the command is not used as a filter. 
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NAME 

net - execute a command on the PCL network 
SYNOPSIS 

net system [ command [ args ] ] 

DESCRIPTION 

Net provides a bi-directional connection to another UNIX System. The first argument is the name of the 
remote system. The second argument is a command to be executed. Any remaining arguments are passed 
to the given command as arguments. 

System can be any name that exists in the directory /dev/pcl followed by a channel number. Net passes the 
local nodename to the remote system . 

All commands are passed to the user’s default shell on the remote system executing in the user’s home 
directory. If command is not given, then the default command is an interactive shell (/bin/sh -i). Before 
execution starts, the user’s environment is extracted from the remote .profile file, if any. 

Net reads the standard input, thus allowing command to be part of a “pipeline” if command reads the stan¬ 
dard input also. 

At the remote end, a daemon logs all commands. 

EXAMPLES 

Execute the w/zo(l) command on system A and return the output to your terminal: 
net A who 

Copy one file from system A to the local system: 

net A "cat /file/on/A" > /file/on/localsys 
Copy a directory structure from system A to the local system: 
cd /dir/on/localsys 

net A "cd /dir/on/A; find . -print I cpio -oc" I cpio -icd 

Send a directory structure from the local system to system A (this uses the command's ability to read stan¬ 
dard input): 

find . -print I cpio -oc I net A "cd /dir/on/A; cpio -icd" 

FILES 

/dev/pcl/* [0-7] PCL channel interfaces for system *. 

/usr/adm/pcllog 

Activity log. 

SEE ALSO 

cpio(l), find(l), pcldaemon(lC), sh( 1), pcl(7). 

DIAGNOSTICS 

uid unknown 

Your uid cannot be matched in the password file. 
command list too long 

A command and its arguments are restricted to less than 512 bytes. 

user is unknown at remote 

Your login name does not exist at the remote site. 

user is denied access at remote 

Your login name is not allowed to be used via net at the remote site. N.B. This applies in particu¬ 
lar to super-users. 

home directory inaccessible 

Your remote home directory is unavailable, possibly unmounted. 
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cannot open channel to system 

A connection can’t be made to the requested system. 

connection broken 

A non-recoverable write error occurred. 
write error 

A recoverable write error occurred. The write will be retried until it completes successfully with¬ 
out losing data. 

cannot fork reader process 

Net is unable to create a reader process and a writer process. 

WARNINGS 

A successful invocation of net reads at least 2 blocks of the standard input, if present, even if command 
does not use standard input. The standard input must be explicitly closed (via <&-) or redirected (such as 
from /dev/null) if this feature is not desired. 

The use of net to invoke certain programs on the remote system may result in delayed transmission of out¬ 
put to the user. This is because the PCL is not a tty device. Data written to standard output by an invoked 
program will be treated as though it is being written to an ordinary file, and not to a user terminal. 

BUGS 

PCL channels are not “tty” files, so that commands that do “funny” things with your terminal (i.e., 
cu{ 1C), passxvd (I), su( 1), etc.), or that expect “tty” behaviour of the standard output file, won't work as 
expected. 
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NAME 

newform - change the format of a text file 
SYNOPSIS 

newform [-s] [-itabspec] [-otabspec] [-bn] [-en] [-pn] [-an] [-f] [-cchar] [-In] [files] 

DESCRIPTION 

Newform reads lines from the named files, or the standard input if no input file is named, and reproduces 
the lines on the standard output. Lines are reformatted in accordance with command line options in effect. 

Except for -s, command line options may appear in any order, may be repeated, and may be intermingled 
with the optional files. Command line options are processed in the order specified. This means that option 
sequences like “-el5 -160” will yield results different from “-160 -el5”. Options are applied to all files 
on the command line. 

-itabspec Input tab specification: expands tabs to spaces, according to the tab specifications given. 

Tabspec recognizes all tab specification forms described in tabs( 1). In addition, tabspec may 
be —, in which newform assumes that the tab specification is to be found in the first line read 
from the standard input (see fspec (A)). If no tabspec is given, tabspec defaults to -8. A 
tabspec of -0 expects no tabs; if any are found, they are treated as -1. 

-otabspec Output tab specification: replaces spaces by tabs, according to the tab specifications given. The 
tab specifications are the same as for -i tabspec. If no tabspec is given, tabspec defaults to -8. 
A tabspec of -0 means that no spaces will be converted to tabs on output. 

-In Set the effective line length to n characters. If n is not entered, -1 defaults to 72. The default 

line length without the -1 option is 80 characters. Note that tabs and backspaces are considered 
to be one character (use -i to expand tabs to spaces). 

-bn Truncate n characters from the beginning of the line when the line length is greater than the 

effective line length (see -In). Default is to truncate the number of characters necessary to 
obtain the effective line length. The default value is used when -b with no n is used. This 
option can be used to delete the sequence numbers from a COBOL program as follows: 
newform -11 -b7 file-name 

The -11 must be used to set the effective line length shorter than any existing line in the file so 
that the -b option is activated. 

-en Same as -bn except that characters are truncated from the end of the line. 

-ck Change the prefix/append character to k. Default character for k is a space. 

-pn Prefix n characters (see -ck) to the beginning of a line when the line length is less than the 

effective line length. Default is to prefix the number of characters necessary to obtain the 
effective line length. 

-an Same as -pn except characters are appended to the end of a line. 

-f Write the tab specification format line on the standard output before any other lines are output. 

The tab specification format line which is printed will correspond to the format specified in the 
last -o option. If no -o option is specified, the line which is printed will contain the default 
specification of -8. 

-s Shears off leading characters on each line up to the first tab and places up to 8 of the sheared 

characters at the end of the line. If more than 8 characters (not counting the first tab) are 
sheared, the eighth character is replaced by a * and any characters to the right of it are dis¬ 
carded. The first tab is always discarded. 

An error message and program exit will occur if this option is used on a file without a tab on 
each line. The characters sheared off are saved internally until all other options specified are 
applied to that line. The characters are then added at the end of the processed line. 


Page 1 



NEWFORM(l) 


NEWFORM(l) 


For example, to convert a file with leading digits, one or more tabs, and text on each line, to a 
file beginning with the text, all tabs after the first expanded to spaces, padded with spaces out 
to column 72 (or truncated to column 72), and the leading digits placed starting at column 73, 
the command would be: 

newform -s -i -1 -a -e file-name 


DIAGNOSTICS 


All diagnostics are fatal. 
usage: ... 
not -s format 
can’t open file 
internal line too long 
tabspec in error 

tabspec indirection illegal 


Newform was called with a bad option. 

There was no tab on one line. 

Self explanatory. 

A line exceeds 512 characters after being expanded in the internal work buffer. 

A tab specification is incorrectly formatted, or specified tab stops are not 
ascending. 

A tabspec read from a file (or standard input) may not contain a tabspec refer¬ 
encing another file (or standard input). 


EXIT CODES 

0 - normal execution 
1 - for any error 


SEE ALSO 

csplit(l), tabs(l), fspec(4). 


BUGS 

Newform normally only keeps track of physical characters; however, for the -i and -o options, newform 
will keep track of backspaces in order to line up tabs in the appropriate logical columns. 

Newform will not prompt the user if a tabspec is to be read from the standard input (by use of -i— or 

-o—). 

If the -f option is used, and the last -o option specified was -o—, and was preceded by either a -o— or a 
-i—, the tab specification format line will be incorrect. 
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NAME 

newgrp - log in to a new group 

SYNOPSIS 

newgrp [-] [group] 

DESCRIPTION 

Newgrp changes the group identification of its caller, analogously to login( 1). The same person remains 
logged in, and the current directory is unchanged, but calculations of access permissions to files are per¬ 
formed with respect to the new group ID. 

Newgrp without an argument changes the group identification to the group in the password file; in effect it 
changes the group identification back to the caller’s original group. 

An initial - flag causes the environment to be changed to the one that would be expected if the user actually 
logged in again. 

A password is demanded if the group has a password and the user himself does not, or if the group has a 
password and the user is not listed in /etc/group as being a member of that group. 

When most users log in, they are members of the group named other. 

FILES 

/etc/group 

/etc/passwd 

SEE ALSO 

login(l), group(4). 

BUGS 

There is no convenient way to enter a password into /etc/group. Use of group passwords is not encour¬ 
aged, because, by their very nature, they encourage poor security practices. Group passwords may disap¬ 
pear in the future. 
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NAME 

news - print news items 
SYNOPSIS 

news [ -a ] [ -n ] [ -s ] [ items ] 

DESCRIPTION 

News is used to keep the user informed of current events. By convention, these events are described by 
files in the directory /usr/news. 

When invoked without arguments, news prints the contents of all current files in /usr/news, most recent 
first, with each preceded by an appropriate header. News stores the “currency” time as the modification 
date of a file named news time in the user’s home directory (the identity of this directory is determined by 
the environment variable $HOME); only files more recent than this currency time are considered “current.” 

The -a option causes news to print all items, regardless of currency. In this case, the stored time is not 
changed. 

The -n option causes news to report the names of the current items without printing their contents, and 
without changing the stored time. 

The -s option causes news to report how many current items exist, without printing their names or contents, 
and without changing the stored time. It is useful to include such an invocation of news in one’s .profile 
file, or in the system’s /etc/profile. 

All other arguments are assumed to be specific news items that are to be printed. 

If a delete is typed during the printing of a news item, printing stops and the next item is started. Another 
delete within one second of the first causes the program to terminate. 

FILES 

/etc/profile 

/usr/news/* 

$HOME/ newstime 

SEE ALSO 

profile(4), environ(5). 
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NAME 

nice - run a command at low priority 
SYNOPSIS 

nice [ -increment ] command [ arguments ] 

DESCRIPTION 

Nice executes command with a lower CPU scheduling priority. If the increment argument (in the range 1- 
19) is given, it is used; if not, an increment of 10 is assumed. 

The super-user may run commands with priority higher than normal by using a negative increment, e.g., 

— 10 . 

SEE ALSO 

nohup(l), nice(2). 

DIAGNOSTICS 

Nice returns the exit status of the subject command. 

BUGS 

An increment larger than 19 is equivalent to 19. 
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NAME 

nl - line numbering filter 
SYNOPSIS 

nl [-htype] [-btype] [-ftype] [-vstart#] [-iincr] [-p] [-lnum] [-ssep] [-wwidth] [-nformat] [-ddelim] file 

DESCRIPTION 

Nl reads lines from the named file or the standard input if no file is named and reproduces the lines on the 
standard output. Lines are numbered on the left in accordance with the command options in effect. 

Nl views the text it reads in terms of logical pages. Line numbering is reset at the start of each logical page. 
A logical page consists of a header, a body, and a footer section. Empty sections are valid. Different line 
numbering options are independently available for header, body, and footer (e.g. no numbering of header 
and footer lines while numbering blank lines only in the body). 

The start of logical page sections are signaled by input lines containing nothing but the following delimiter 
character(s): 


Line contents 

Start of 

\:\:\: 

header 

\:\: 

body 

\: 

footer 


Unless optioned otherwise, nl assumes the text being read is in a single logical page body. 

Command options may appear in any order and may be intermingled with an optional file name. Only one 

file may be named. The options are: 

-b type Specifies which logical page body lines are to be numbered. Recognized types and their mean¬ 

ing are: a, number all lines; t, number lines with printable text only; n, no line numbering; 
p string, number only lines that contain the regular expression specified in string. Default type 
for logical page body is t (text lines numbered). 

-h type Same as -b type except for header. Default type for logical page header is n (no lines num¬ 

bered). 

-f type Same as -b type except for footer. Default for logical page footer is n (no lines numbered). 

-p Do not restart numbering at logical page delimiters. 

-ystart# Start # is the initial value used to number logical page lines. Default is 1. 

-iincr Incr is the increment value used to number logical page lines. Default is 1. 

-ssep Sep is the character(s) used in separating the line number and the corresponding text line. 

Default sep is a tab. 

-wwidth Width is the number of characters to be used for the line number. Default width is 6. 

-n format Format is the line numbering format. Recognized values are: In, left justified, leading zeroes 

supressed; rn, right justified, leading zeroes supressed; rz, right justified, leading zeroes kept. 
Default format is rn (right justified). 

-lnum Num is the number of blank lines to be considered as one. For example, -12 results in only the 
second adjacent blank being numbered (if the appropriate -ha, -ba, and/or -fa option is set). 
Default is 1. 

-dxv The delimiter characters specifying the start of a logical page section may be changed from the 

default characters (\:) to two user specified characters. If only one character is entered, the sec¬ 
ond character remains the default character (:). No space should appear between the -d and the 
delimiter characters. To enter a backslash, use two backslashes. 
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EXAMPLE 

The command: 

nl -vlO -ilO -d!+ filel file2 

will number files 1 and 2 starting at line number 10 with an increment of ten. The logical page delimiters 
are !+. 


SEE ALSO 

pr(l). 
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NAME 

nm - print name list of common object file 
SYNOPSIS 

nm [-o] [—x] [-h] [—v] [—n] [—e] [-f] [-u] [-V] file-names 
DESCRIPTION 

The nm command displays the symbol table of each common object file file-name. File-name may be a 
relocatable or absolute common object file; or it may be an archive of relocatable or absolute common 
object files. For each symbol, the following information will be printed: 

Name The name of the symbol. 

Value Its value expressed as an offset or an address depending on its storage class. 

Class Its storage class. 

Type Its type and derived type. If the symbol is an instance of a structure or of a union then the struc¬ 
ture or union tag will be given following the type (e.g. struct-tag). If the symbol is an array, 
then the array dimensions will be given following the type (eg., char[n][m]). Note that the 
object file must have been compiled with the -g option of the cc(l) command for this informa¬ 
tion to appear. 

Size Its size in bytes, if available. Note that the object file must have been compiled with the -g 
option of the cc(l) command for this information to appear. 

Line The source line number at which it is defined, if available. Note that the object file must have 
been compiled with the -g option of the cc(l) command for this information to appear. 

Section For storage classes static and external, the object file section containing the symbol (e.g., text, 
data or bss). 

The output of nm may be controlled using the following flags: 

-o A symbol’s value and size will be printed in octal instead of decimal. 

-x A symbol’s value and size will be printed in hexadecimal instead of decimal. 

-h The output header data is not displayed. 

-v External symbols will be sorted by value before they are printed. 

-n External symbols will be sorted by name before they are printed. 

-e Only static and external symbols are printed. 

-f Full output is produced. Redundant symbols (.text, .data and .bss), normally suppressed, are 

printed. 

-u Only undefined symbols are printed. 

-V Version of nm command executing is displayed on stderr output. 

Flags may be used in any order, either singly or in combination, and may appear anywhere in the command 
line. Therefore, both nm name -e -v and nm -ve name print the static and external symbols in name , 
with external symbols sorted by value. 

FILES 

/usr/tmp/nm?????? 

SEE ALSO 

as(l), cc(l), ld(l), a.out(4), ar(4). 

DIAGNOSTICS 

“nm: name: cannot open’’ 

if name cannot be read. 
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“nm: name: bad magic” 

if name is not an appropriate common object file. 

‘ ‘nm: name: no symbols’ ’ 

if the symbols have been stripped from name. 
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NAME 

nm - print name list 
SYNOPSIS 

nm [ -gnoprsu ][ file ... ] 

DESCRIPTION 

Nm prints the name list (symbol table) of each object file in the argument list. If an argument is an archive, 
a listing for each object file in the archive will be produced. If no file is given, the symbols in a.out are 
listed. 

Each symbol name is preceded by its value (blanks if undefined) and one of the letters U (undefined), A 
(absolute), T (text segment symbol), D (data segment symbol), B (bss segment symbol), R (register sym¬ 
bol), F (file symbol), or C (common symbol). If the symbol is local (non-external) the type letter is in 
lower case. The output is sorted alphabetically. 

Options are: 

-g Print only global (external) symbols. 

-n Sort numerically rather than alphabetically. 

-o Prefix file or archive element name to each output line rather than only once. This option can be 
used to make piping to grep{ 1) more meaningful. 

-p Don’t sort; print in symbol-table order. 

-r Sort in reverse order. 

-s Sort according to the size of the external symbol (computed from the difference between the value 
of the symbol and the value of the symbol with the next highest value). This difference is the 
value printed. This flag turns on -g and -n and turns off -u and -p. 

-u Print only undefined symbols. 

SEE ALSO 

ar(l), a.out(4), ar(4). 
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NAME 

nohup - run a command immune to hangups and quits 
SYNOPSIS 

nohup command [ arguments ] 

DESCRIPTION 

Nohup executes command with hangups and quits ignored. If output is not re-directed by the user, it will 
be sent to nohup.out. If nohup.out is not writable in the current directory, output is redirected to 

$HOME/nohup.out. 

SEE ALSO 

nice(l), signal(2). 


Page 1 



NROFF(l) 


NROFF(l) 


NAME 

nroff - format text 


SYNOPSIS 

nroff [ options ] [ files ] 


DESCRIPTION 

Nroff formats text contained in files (standard input by default) for printing on typewriter-like devices and 
line printers. Its capabilities are described in the NROFF/TROFF User’s Manual cited below. 

An argument consisting of a minus (-) is taken to be a file name corresponding to the standard input. The 
options, which may appear in any order, but must appear before th e files, are: 


-o list Print only pages whose page numbers appear in the list of numbers and ranges, separated by 
commas. A range N—M means pages N through M; an initial -N means from the beginning to 
page A; and a final N- means from N to the end. (See BUGS below.) 

-n N Number first generated page N. 

-sN Stop every N pages. Nroff will halt after every N pages (default N=\ ) to allow paper loading or 
changing, and will resume upon receipt of a line-feed or new-line (new-lines do not work in pipe¬ 
lines, e.g., with mm ( 1)). This option does not work if the output of nroff is piped through co/(l). 
When nroff halts between pages, an ASCII BEL is sent to the terminal. 

-r aN Set register a (which must have a one-character name) to N. 

-i Read standard input after files are exhausted. 

-q Invoke the simultaneous input-output mode of the ,rd request. 

-z Print only messages generated by ,tm (terminal message) requests. 

-m name Prepend to the input files the non-compacted (ASCII text) macro file /usr/Iib/tmac/tmac.na»!e. 

-c name Prepend to the input files the compacted macro files /iisr/lib/niacros/cmp.[nt].[dt].;;a/«c and 
/usr/lib/macros/ucmp,[nt].nawe. 

-k name Compact the macros used in this invocation of nroff, placing the output in files [dt ].name in the 
current directory (see the May 1979 Addendum to the NROFF/TROFF User’s Manual for details 
of compacting macro files). 

-T name Prepare output for specified terminal. Known names are 37 for the (default) TELETYPE.nh 


FILES 


Model 37 terminal, tn300 for the GE TermiNet 300 (or any terminal without half-line capability), 
300s for the DASI 300s, 300 for the DASI 300, 450 for the DASI 450, lp for a (generic) ASCII line 
printer, 382 for the DTC-382, 4000A for the Trendata 4000A, 832 for the Anderson Jacobson 
832, X for a (generic) EBCDIC printer, and 2631 for the Hewlett Packard 2631 line printer. 

-e Produce equally-spaced words in adjusted lines, using the full resolution of the particular termi¬ 

nal. 

-h Use output tabs during horizontal spacing to speed output and reduce output character count. Tab 

settings are assumed to be every 8 nominal character widths. 

-u n Set the emboldening factor (number of character overstrikes) for the third font position (bold) to 

n, or to zero if n is missing. 


/usr/lib/suftab 

/tmp/ta$# 

/usr/lib/tmac/tmac.* 
/usr/lib/macros/* 
/usr/lib/term/* 


suffix hyphenation tables 
temporary file 

standard macro files and pointers 

standard macro files 

terminal driving tables for nroff 


SEE ALSO 

NROFF/TROFF User’s Manual 
A TROFF Tutorial 

col(l), cw(l), eqn(l), greek(l), mm(l), tbl(l), troffi l), mm(5). 


BUGS 

Nroff believes in Eastern Standard Time; as a result, depending on the time of the year and on your local 
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time zone, the date that nroff generates may be off by one day front your idea of what the date is. 

When nroff is used with the -o list option inside a pipeline (e.g., with one or more of cw(l), eqn(l), and 
tbl( 1)), it may cause a harmless “broken pipe” diagnostic if the last page of the document is not specified 
in list. 
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NAME 

nscstat - query the operation status of the NSC network 
SYNOPSIS 

nscstat [ netname ... ] [-ludqrbpa] [-n names ] 

DESCRIPTION 

Nscstat, without arguments, gives a short operational status report of the NSC network from the viewpoint 
of the local node. This includes the status of the NSC network and the total number of files queued for 
transmission. A list of network names may be specified. If no network names are given, the options 
specified are performed for all known networks. Nscstat recognizes the following arguments: 

-1 Output a long listing. This option indicates the status of the printed node (on-line or off-line), the total 
number of files queued waiting transmission to this node, and the time when the first job was queued for 
transmission. 

-P 

Report the last time the system received a poke from remote systems. 

-r Report the last time the system received a request to transfer from remote systems. 

-b 

Report the last time the current system had to notify remote systems that it was too busy to handle its 
request. 

-u 

List the status of all nodes that are on-line (up). 

-d 

List the status of all nodes that are off-line (down). 

-q 

List the status of all nodes that have files queued for transmission. 

-a 

List the status of all nodes configured on the network. 


-n names 

Name specifies that status is requested for this node only. If more than one network is specified, this 
option is disabled. 

Each of the above arguments may be used singly or together with several others. When used together, the 
output is the intersection of the sets of nodes matching each option. If a node name list is specified, status 
for that node will only be reported if it is in the intersection set of the specified options. 

EXAMPLE 

To get a long listing of all nodes that are currently off-line and have files queued for transmission: 
nscstat -Idq 


FILES 


BUGS 


/usr/nsc/rvchan list of nodes currently configured on the network 
/usr/nsc/cons/* nodes that are considered on-line 
/usr/nsc/jobs/C* jobs queued for transmission 
/usr/nsc/cons/on-line/* 

whether the NSC network is active or not on this network 

Nscstat tries to interpret the specified options intelligently. If none of the options specified apply to any of 
the specified nodes, no detailed status will be reported. 
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NAME 

nsctorje - re-route jobs from the NSC network to RJE 

SYNOPSIS 

nsctorje [-d names] 

DESCRIPTION 

Nsctorje will resubmit jobs queued on the NSC local network (via nusencK 1C) across the RJE link (if it 
exists). Nsctorje submits a nusend{ 1C) command to re-route each queued job. By default, jobs will be re¬ 
routed if either the remote host is marked down locally or if the NSC network on the local host is inactive. 
Nsctorje recognizes the following options: 

-d names re-route all jobs queued only to the remote machine name. 

SEE ALSO 

nusend(lC). 

nscmon(lM), rje(8) in the UNIX System Administrator’s Manual. 

FILES 

/usr/nsc/NORJE file indicating that no RJE connection exists on this machine 

/usr/nsc/rvchan nusendi 1C) network configuration file 

/usr/asp/udest nodes accessible through RJE 

BUGS 

Any file larger than 190,000 bytes will not be re-routed across the RJE link. It will remain queued on the 
NSC network until the remote node becomes available. 
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NAME 

nusend - send files to another UNIX System on the NSC network 

SYNOPSIS 

nusend -d dest [-n netname] [-a acct] [-m] [-e] [-s] [-c] [-x] [-u destuser] [ [-f destfile] srcfile] [-!cmd 
[cmdfile] ] ... 

DESCRIPTION 

Nusend sends copies of the named files or command to another UNIX system via the NSC network. If the 
file name - is given, the standard input is read at that point. 

-d dest Destination. Dest can be any one of the UNIX systems on the NSC local network. See 
/usr/nsc/rvchan for an up-to-date list of valid NSC destinations. 

-n netname 

Network name. Netname can be any one of the networks known to the local system (see 
nscmon (1M) for the definition of a network. This option is only needed when sending to your own 
system. See /usr/nsc/nets for the up-to-date list of valid networks). 

-a acct Use acct as the account number for the job. By default, the account number is read from the pass¬ 
word file. 

-s Silent. Suppress the one-line message which contains the submitted job name. 

-c Copy. Make a copy of the file. Default is to set up a pointer to the file in the user’s directory. If 

any changes are made to the file before transmission, the changes will be sent to the destination 
unless the -c option is used. 

-x Generate checksums on all data tranmissions. 

Mail will normally be sent to the receiving login(s) to report the receipt of the file(s). Mail will be sent to 
both sending and receiving logins if there were errors in transmission. The default may be overridden with 
the following switches: 

-m Report by mail( 1) when the file transfer is complete. The mail is sent from the remote system via 
nusend. 

-e Report by mail{ 1) only when an error occurred during the transfer. No other mail will be sent. 

Normally, the login name under which the new file will appear on the destination system is the same as the 
login name of the person who issues the command. 

The following options, each as a separate argument, may be interspersed with file name arguments: 

-u Use the next argument as the destination user’s login name for all succeeding files. 

-f Use the next argument as the destination file name for the succeeding file. Srcfile must be 
specified. The destination path name is assumed to be relative to the destination login directory if 
there is no leading /. In either case, the target directory must be mode 777, or if the file already 
exists, the file must be writable by others. By default, files are delivered to directory rje under the 
destination login directory. Rje must have been previously created in mode 777 for everything to 
work. The name of the destination file is ordinarily the same as the last component of the original 
file. When the standard input is sent, the destination file name is normally taken to be pipe.end. If 
- is used, the standard input is taken. 

-!cmd Cmd is sent to the remote machine for execution. A file name or - can be used as standard input to 
the command. If no file is specified, /dev/null is used. 

EXAMPLES 

Assuming XXAAA, XXBBB and XXCCC are machines on the NSC network, then: 

To send files filel ,file2, and filed to XXAAA (assuming the source and destination logins are the same): 
nusend -d XXAAA filel file2 file3 
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To send file cprog.c to login name dave on XXBBB and to get confirmation mail returned: 
nusend -d XXBBB -m -u dave cprog.c 

To send file myfile to XXCCC and rename it to yourfile (assuming the source and destination logins are the 
same): 

nusend d XXCCC -f yourfile myfile 

To send file a.out from XXAAA to login name debbie on XXBBB via remote execution: 

nusend-d XXAAA .RS -! 'nusend -d XXBBB -u debbie ' logdir debbie' /a.out- 

FILES 

/etc/passwd account number for NSC job 

/usr/nsc/jobs/C* job queue area 

/usr/nsc/rvchan table of known destinations 

/usr/nsc/nets table of known networks 

/usr/nsc/log/nusend usage log 

SEE ALSO 

mail(l), nscstat(lC). 


Page 2 



OD(l) 


OD(l) 


NAME 

od - octal dump 
SYNOPSIS 

od [ -bcdosx ] [ file ] [ [ + ]offset[. ][ b ] ] 

DESCRIPTION 

Od dumps file in one or more formats as selected by the first argument. If the first argument is missing, -o 
is default. The meanings of the format options are: 

-b Interpret bytes in octal. 

-c Interpret bytes in ASCII. Certain non-graphic characters appear as C escapes: null=\0, 
backspace=\b, form-feed=\f, new-line=\n, return=\r, tab=\t; others appear as 3-digit octal numbers. 

-d Interpret words in unsigned decimal. 

-o Interpret words in octal. 

-s Interpret 16-bit words in signed decimal. 

-x Interpret words in hex. 

The file argument specifies which file is to be dumped. If no file argument is specified, the standard input is 
used. 

The offset argument specifies the offset in the file where dumping is to commence. This argument is nor¬ 
mally interpreted as octal bytes. If . is appended, the offset is interpreted in decimal. If b is appended, the 
offset is interpreted in blocks of 512 bytes. If the file argument is omitted, the offset argument must be pre¬ 
ceded by +. 

Dumping continues until end-of-file. 

SEE ALSO 

dump(l). 
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NAME 

pack, peat, unpack - compress and expand files 

SYNOPSIS 

pack [ - ] name ... 

peat name ... 

unpack name ... 

DESCRIPTION 

Pack attempts to store the specified files in a compressed form. Wherever possible (and useful), each input 
file name is replaced by a packed file name. z with the same access modes, access and modified dates, and 
owner as those of name. If pack is successful, name will be removed. Packed files can be restored to their 
original form using unpack or peat. 

Pack uses Huffman (minimum redundancy) codes on a byte-by-byte basis. If the - argument is used, an 
internal flag is set that causes the number of times each byte is used, its relative frequency, and the code for 
the byte to be printed on the standard output. Additional occurrences of - in place of name will cause the 
internal flag to be set and reset. 

The amount of compression obtained depends on the size of the input file and the character frequency dis¬ 
tribution. Because a decoding tree forms the first part of each ,z file, it is usually not worthwhile to pack 
files smaller than three blocks, unless the character frequency distribution is very skewed, which may occur 
with printer plots or pictures. 

Typically, text files are reduced to 60-75% of their original size. Load modules, which use a larger charac¬ 
ter set and have a more uniform distribution of characters, show little compression, the packed versions 
being about 90% of the original size. 

Pack returns a value that is the number of files that it failed to compress. 

No packing will occur if: 

the file appears to be already packed; 

the file name has more than 12 characters; 

the file has links; 

the file is a directory; 

the file cannot be opened; 

no disk storage blocks will be saved by packing; 

a file called name. z already exists; 

the .z file cannot be created; 

an I/O error occurred during processing. 

The last segment of the file name must contain no more than 12 characters to allow space for the appended 
.z extension. Directories cannot be compressed. 

Peat does for packed files what cat( 1) does for ordinary files. The specified files are unpacked and written 
to the standard output. Thus to view a packed file named name. z use; 

peat name.z 

or just: 

peat name 

To make an unpacked copy, say nnn , of a packed file named name.z (without destroying name.z) use the 
command: 

peat name >nnn 

Peat returns the number of files it was unable to unpack. Failure may occur if: 

the file name (exclusive of the .z) has more than 12 characters; 

the file cannot be opened; 

the file does not appear to be the output of pack. 
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Unpack expands files created by pack. For each file name specified in the command, a search is made for a 
file called name .z (or just name, if name ends in ,z). If this file appears to be a packed hie, it is replaced by 
its expanded version. The new hie has the .z suffix stripped from its name, and has the same access modes, 
access and modification dates, and owner as those of the packed hie. 

Unpack returns a value that is the number of hies it was unable to unpack. Failure may occur for the same 
reasons that it may in peat, as well as for the following: 

a hie with the ‘ ‘unpacked'' name already exists; 
if the unpacked hie cannot be created. 
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NAME 

passwd - change login password 

SYNOPSIS 

passwd name 

DESCRIPTION 

This command changes (or installs) a password associated with the login name. 

The program prompts for the old password (if any) and then for the new one (twice). The caller must sup¬ 
ply these. New passwords should be at least four characters long if they use a sufficiently rich alphabet and 
at least six characters long if monocase. Only the first eight characters of the password are significant. 

Only the owner of the name or the super-user may change a password; the owner must prove he knows the 
old password. Only the super-user can create a null password. 

The password file is not changed if the new password is the same as the old password, or if the password 
has not “aged” sufficiently; see passwd( 4). 

FILES 

/etc/passwd 

SEE ALSO 

login(l), crypt(3C), passwd(4). 
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NAME 

paste - merge same lines of several files or subsequent lines of one file 

SYNOPSIS 

paste file 1 file2 ... 
paste -d list filel file2 ... 
paste -s [— d list] filel file2 ... 

DESCRIPTION 

In the first two forms, paste concatenates corresponding lines of the given input files file 1, jile2, etc. It 
treats each file as a column or columns of a table and pastes them together horizontally (parallel merging). 
If you will, it is the counterpart of cat{ 1) which concatenates vertically, i.e., one file after the other. In the 
last form above, paste subsumes the function of an older command with the same name by combining sub¬ 
sequent lines of the input file (serial merging). In all cases, lines are glued together with the tab character, 
or with characters from an optionally specified list. Output is to the standard output, so it can be used as 
the start of a pipe, or as a filter, if - is used in place of a file name. 

The meanings of the options are: 

-d Without this option, the new-line characters of each but the last file (or last line in case of the -s 
option) are replaced by a tab character. This option allows replacing the tab character by one or 
more alternate characters (see below). 

list One or more characters immediately following -d replace the default tab as the line concatenation 
character. The list is used circularly, i. e. when exhausted, it is reused. In parallel merging (i. e. 
no -s option), the lines from the last file are always terminated with a new-line character, not from 
the list. The list may contain the special escape sequences: \n (new-line), \t (tab), W (backslash), 
and \0 (empty string, not a null character). Quoting may be necessary, if characters have special 
meaning to the shell (e.g. to get one backslash, use -d "\\\\ "). 

-s Merge subsequent lines rather than one from each input file. Use tab for concatenation, unless a 
list is specified with -d option. Regardless of the list, the very last character of the file is forced to 
be a new-line. 

- May be used in place of any file name, to read a line from the standard input. (There is no prompt¬ 

ing). 

EXAMPLES 

Is I paste -d" " - list directory in one column 

Is I paste- list directory in four columns 

paste -s -d"\t\n" file combine pairs of lines into lines 

SEE ALSO 

grep(l), cut(l), 

pr(l): pr -t -m.. . works similarly, but creates extra blanks, tabs and new-lines for a nice page layout. 

DIAGNOSTICS 

line too long Output lines are restricted to 511 characters. 

too many files Except for -s option, no more than 12 input files may be specified. 
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NAME 

pr - print files 

SYNOPSIS 

pr [ options ] [ files ] 

DESCRIPTION 

Pr prints the named files on the standard output. If file is or if no files are specified, the standard input is 
assumed. By default, the listing is separated into pages, each headed by the page number, a date and time, 
and the name of the file. 

By default, columns are of equal width, separated by at least one space; lines which do not fit are truncated. 
If the -s option is used, lines are not truncated and columns are separated by the separation character. 

If the standard output is associated with a terminal, error messages are withheld until pr has completed 
printing. 

The below options may appear singly or be combined in any order: 

+k Begin printing with page k (default is 1). 

-k Produce ^-column output (default is 1). The options -e and -i are assumed for multi-column out¬ 
put. 

-a Print multi-column output across the page. 

-m Merge and print all files simultaneously, one per column (overrides the -k, and -a options). 

-d Double-space the output. 

-eck Expand input tabs to character positions k+ 1, 2*k+\, 3*£+l, etc. If k is 0 or is omitted, default 
tab settings at every eighth position are assumed. Tab characters in the input are expanded into the 
appropriate number of spaces. If c (any non-digit character) is given, it is treated as the input tab 
character (default for c is the tab character). 

-i ck In output, replace white space wherever possible by inserting tabs to character positions k+ 1, 

2*k+l, 3*£+l, etc. If k is 0 or is omitted, default tab settings at every eighth position are assumed. 
If c (any non-digit character) is given, it is treated as the output tab character (default for c is the 
tab character). 

-nek Provide Ar-digit line numbering (default for k is 5). The number occupies the first k+ 1 character 
positions of each column of normal output or each line of -m output. If c (any non-digit charac¬ 
ter) is given, it is appended to the line number to separate it from whatever follows (default for c is 
a tab). 

-w k Set the width of a line to k character positions (default is 72 for equal-width multi-column output, 

no limit otherwise). 

-ok Offset each line by k character positions (default is 0). The number of character positions per line 
is the sum of the width and offset. 

-Ik Set the length of a page to k lines (default is 66). 

-h Use the next argument as the header to be printed instead of the file name. 

-p Pause before beginning each page if the output is directed to a terminal (pr will ring the bell at the 

terminal and wait for a carriage return). 

-f Use form-feed character for new pages (default is to use a sequence of line-feeds). Pause before 
beginning the first page if the standard output is associated with a terminal. 

-r Print no diagnostic reports on failure to open files. 

-t Print neither the five-line identifying header nor the five-line trailer normally supplied for each 

page. Quit printing after the last line of each file without spacing to the end of the page. 
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-sc Separate columns by the single character c instead of by the appropriate number of spaces (default 
for c is a tab). 

EXAMPLES 

Print filel and file2 as a double-spaced, three-column listing headed by “file list”: 
pr -3dh "file list" filel file2 

Write filel on file2, expanding tabs to columns 10, 19, 28, 37, : 

pr -e9 -t <filel >file2 

FILES 

/dev/tty*to suspend messages 

SEE ALSO 

cat(l). 
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NAME 

prof - display profile data 
SYNOPSIS 

prof [-tcan] [-ox] [—g] [-z] [—h] [-s] [-m mdata] [prog] 

DESCRIPTION 

Prof interprets the profile file produced by the monitor{ 3C) function. The symbol table in the object file 
prog (a.out by default) is read and correlated with the profile file (mon.out by default). For each external 
text symbol the percentage of time spent executing between the address of that symbol and the address of 
the next is printed, together with the number of times that function was called and the average number of 
milliseconds per call. 

The mutually exclusive options t, c, a, and n determine the type of sorting of the output lines: 

-t Sort by decreasing percentage of total time (default). 

-c Sort by decreasing number of calls. 

-a Sort by increasing symbol address. 

-n Sort lexically by symbol name. 

The mutually exclusive options o and x specify the printing of the address of each symbol monitored: 

-o Print each symbol address (in octal) along with the symbol name. 

-x Print each symbol address (in hexadecimal) along with the symbol name. 

The following options may be used in any combination: 

-g Include non-global symbols (static functions). 

-z Include all symbols in the profile range (see monitor( 3C)), even if associated with zero number of 
calls and zero time. 

-h Suppress the heading normally printed on the report. (This is useful if the report is to be processed 
further.) 

-s Print a summary of several of the monitoring parameters and statistics on the standard error out¬ 
put. 

-m mdata 

Use file mdata instead of mon.out for profiling data. 

For the number of calls to a function to be tallied, the -p option of cc(l) must have been given when the 
file containing the function was compiled. This option to the cc command also arranges for the object file 
to include a special profiling start-up function that calls monitor (?>C) at the beginning and end of execution. 
It is the call to monitor at the end of execution that causes the mon.out file to be written. Thus, only pro¬ 
grams that call exit(2) or return from main will cause the mon.out file to be produced. 

FILES 

mon.out for profile 
a.out for namelist 

SEE ALSO 

cc(l), nm(l), exit(2), profil(2), monitor(3C). 

BUGS 

There is a limit of 300 functions that may have call counters established during program execution. If this 
limit is exceeded, other data will be overwritten and the mon.out file will be corrupted. The number of call 
counters used will be reported automatically by the prof command whenever the number exceeds 250. 
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NAME 

pis - print an SCCS file 
SYNOPSIS 

prs [-d[dataspec]] [-r[SID]] [-e] [-1] [-a] files 
DESCRIPTION 

Prs prints, on the standard output, parts or all of an SCCS file (see sccsfile (4)) in a user supplied format. If 
a directory is named, prs behaves as though each file in the directory were specified as a named file, except 
that non-SCCS files (last component of the path name does not begin with s.), and unreadable files are 
silently ignored. If a name of - is given, the standard input is read; each line of the standard input is taken 
to be the name of an SCCS file or directory to be processed; non-SCCS files and unreadable files are silently 
ignored. 

Arguments to prs , which may appear in any order, consist of keyletter arguments, and file names. 

All the described keyletter arguments apply independently to each named file: 

-d [dataspec] Used to specify the output data specification. The dataspec is a string consisting 
of SCCS file data keywords (see DATA KEYWORDS) interspersed with optional user 
supplied text. 

-r[S/£>] Used to specify the SCCS /Dentification (SID) string of a delta for which informa¬ 

tion is desired. If no SID is specified, the SID of the most recently created delta is 
assumed. 

-e Requests information for all deltas created earlier than and including the delta 

designated via the -r keyletter. 

-1 Requests information for all deltas created later than and including the delta desig¬ 

nated via the -r keyletter. 

-a Requests printing of information for both removed, i.e., delta type = R, (see 

rmdel( 1)) and existing, i.e., delta type = D. deltas. If the -a keyletter is not 
specified, information for existing deltas only is provided. 

DATA KEYWORDS 

Data keywords specify which parts of an SCCS file are to be retrieved and output. All parts of an SCCS file 
(see sccsfile( 4)) have an associated data keyword. There is no limit on the number of times a data keyword 
may appear in a dataspec. 

The information printed by prs consists of: (1) the user supplied text; and (2) appropriate values (extracted 
from the SCCS file) substituted for the recognized data keywords in the order of appearance in the 
dataspec. The format of a data keyword value is either Simple (S), in which keyword substitution is direct, 
or Multi-line (M), in which keyword substitution is followed by a carriage return. 

User supplied text is any text other than recognized data keywords. A tab is specified by \t and carriage 
return/new-line is specified by \n. 
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TABLE 1. SCCS Files Data Keywords 


Keyword 

Data Item 

File Section 

Value 

Format 

:Dt: 

Delta information 

Delta Table 

See below* 

S 

:DL: 

Delta line statistics 


:Li:/:Ld:/:Lu: 

S 

:Li: 

Lines inserted by Delta 


nnnnn 

S 

:Ld: 

Lines deleted by Delta 


nnnnn 

S 

:Lu: 

Lines unchanged by Delta 


nnnnn 

s 

:DT: 

Delta type 


D or R 

s 

:I: 

SCCS ID string (SID) 


:R:.:L:.:B:.:S: 

s 

:R: 

Release number 


nnnn 

s 

:L: 

Level number 


nnnn 

s 

:B: 

Branch number 


nnnn 

s 

:S: 

Sequence number 


nnnn 

s 

:D: 

Date Delta created 


:Dy:/:Dm:/:Dd: 

s 

:Dy: 

Year Delta created 


nn 

s 

:Dm: 

Month Delta created 


nn 

s 

:Dd: 

Day Delta created 


nn 

s 

:T: 

Time Delta created 


:Th:::Tm:::Ts: 

s 

:Th: 

Hour Delta created 


nn 

s 

:Tm: 

Minutes Delta created 


nn 

s 

:Ts: 

Seconds Delta created 


nn 

s 

:P: 

Programmer who created Delta 


logname 

s 

:DS: 

Delta sequence number 


nnnn 

s 

:DP: 

Predecessor Delta seq-no. 


nnnn 

s 

:DI: 

Seq-no. of deltas inch, excl., ignored 


:Dn:/:Dx:/:Dg: 

s 

:Dn: 

Deltas included (seq #) 


:DS: :DS:... 

s 

:Dx: 

Deltas excluded (seq #) 


:DS: :DS:... 

s 

:Dg: 

Deltas ignored (seq #) 


:DS: :DS:... 

s 

:MR: 

MR numbers for delta 


text 

M 

:C: 

Comments for delta 


text 

M 

:UN: 

User names 

User Names 

text 

M 

:FL: 

Flag list 

Flags 

text 

M 

:Y: 

Module type flag 


text 

S 

:MF: 

MR validation flag 


yes or no 

S 

:MP: 

MR validation pgm name 


text 

s 

:KF: 

Keyword error/warning flag 


yes or no 

s 

:BF: 

Branch flag 


yes or no 

s 

:J: 

Joint edit flag 


yes or no 

s 

:LK: 

Locked releases 


:R:... 

s 

:Q: 

User defined keyword 


text 

s 

:M: 

Module name 


text 

s 

:FB: 

Floor boundary 


:R: 

s 

:CB: 

Ceiling boundary 


:R: 

s 

:Ds: 

Default SID 


:I: 

s 

:ND: 

Null delta flag 


yes or no 

s 

:FD: 

File descriptive text 

Comments 

text 

M 

:BD: 

Body 

Body 

text 

M 

:GB: 

Gotten body 

" 

text 

M 

:W: 

A form of what( 1) string 

N/A 

:Z::M:\t:I: 

S 

:A: 

A form of what( 1) string 

N/A 

:Z::Y: :M: :I::Z: 

S 

:Z: 

what( 1) string delimiter 

N/A 

<§>(#) 

s 

:F: 

SCCS file name 

N/A 

text 

s 

:PN: 

SCCS file path name 

N/A 

text 

s 


* :Dt: = :DT: :I: :D: :T: :P: :DS: :DP: 
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EXAMPLES 

prs -cTUsers and/or user IDs for :F: are:\n:UN:" s.file 

may produce on the standard output: 

Users and/or user IDs for s.file are: 

xyz 

131 

abc 

prs -d"Newest delta for pgm :M:: :I: Created :D: By :P:" -r s.file 
may produce on the standard output: 

Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas 
As a special case: 
prs s.file 

may produce on the standard output: 

D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000 
MRs: 

bl78-12345 
bl79-54321 
COMMENTS: 

this is the comment line for s.file initial delta 

for each delta table entry of the “D” type. The only keyletter argument allowed to be used with the special 
case is the -a keyletter. 

FILES 

/tmp/pr????? 

SEE ALSO 

admin(l), delta(l), get(l), help(l), sccsfile(4). 

Source Code Control System User’s Guide in the UNIX System User’s Guide. 

DIAGNOSTICS 

Use help( 1) for explanations. 
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NAME 

ps - report process status 

SYNOPSIS 

ps [ options ] 

DESCRIPTION 

Ps prints certain information about active processes. Without options, information is printed about pro¬ 
cesses associated with the current terminal. Otherwise, the information that is displayed is controlled by 
the following options: 

-e Print information about all processes. 

-d Print information about all processes, except process group leaders. 

-a Print information about all processes, except process group leaders and processes not associ¬ 

ated with a terminal. 

-f Generate a full listing. (Normally, a short listing containing only process ID, terminal 

(“tty”) identifier, cumulative execution time, and the command name is printed.) See 
below for meaning of columns in a full listing. 

-1 Generate a long listing. See below. 

-c corefile Use the file corefile in place of /dev/mem. 

-s swapdev Use the file swapdev in place of /dev/swap. This is useful when examining a corefile; a 

swapdev of /dev/null will cause the user block to be zeroed out. 

-n namelist The argument will be taken as the name of an alternate namelist (/unix is the default). 

-t tlist Restrict listing to data about the processes associated with the terminals given in tlist, where 

tlist can be in one of two forms: a list of terminal identifiers separated from one another by a 
comma, or a list of terminal identifiers enclosed in double quotes and separated from one 
another by a comma and/or one or more spaces. 

-p plist Restrict listing to data about processes whose process ID numbers are given in plist, where 

plist is in the same format as tlist. 

-u ulist Restrict listing to data about processes whose user ID numbers or login names are given in 

ulist, where ulist is in the same format as tlist. In the listing, the numerical user ID will be 
printed unless the -f option is used, in which case the login name will be printed. 

-g glist Restrict listing to data about processes whose process groups are given in glist, where glist 

is a list of process group leaders and is in the same format as tlist. 

The column headings and the meaning of the columns in a ps listing are given below; the letters f and 1 
indicate the option (full or long ) that causes the corresponding heading to appear; all means that the head¬ 
ing always appears. Note that these two options only determine what information is provided for a process; 
they do not determine which processes will be listed. 

F (1) Flags (octal and additive) associated with the process: 

01 in core; 

02 system process; 

04 locked in core (e.g., for physical I/O); 

10 being swapped; 

20 being traced by another process; 

40 another tracing flag. 

S (1) The state of the process: 

0 non-existent; 

S sleeping; 

W waiting; 

R running; 

I intermediate; 

Z terminated; 

T stopped; 
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UID 

(f,l) 

PID 

(all) 

PPID 

(f,l) 

C 

(f,l) 

STIME 

(f) 

PRI 

(1) 

NI 

0) 

ADDR 

(1) 

SZ 

(1) 

VVCHAN 

0) 

TTY 

(all) 

TIME 

(all) 

CMD 

(all) 


X growing. 

The user ID number of the process owner; the login name is printed under the -f option. 
The process ID of the process; it is possible to kill a process if you know this datum. 

The process ID of the parent process. 

Processor utilization for scheduling. 

Starting time of the process. 

The priority of the process; higher numbers mean lower priority. 

Nice value; used in priority computation. 

The memory address of the process (a pointer to the segment table array on the 3B20S), 
if resident; otherwise, the disk address. 

The size in blocks of the core image of the process. 

The event for which the process is waiting or sleeping; if blank, the process is running. 
The controlling terminal for the process. 

The cumulative execution time for the process. 

The command name; the full command name and its arguments are printed under the -f 
option. 


A process that has exited and has a parent, but has not yet been waited for by the parent, is marked 

<defunct>. 


Under the -f option, ps tries to determine the command name and arguments given when the process was 
created by examining memory or the swap area. Failing this, the command name, as it would appear with¬ 
out the -f option, is printed in square brackets. 


FILES 


/unix 

/dev/mem 

/dev/s wap 

/etc/passwd 

/etc/ps_data 

/dev 


system namelist, 
memory. 

the default swap device. 

supplies UID information. 

internal data structure. 

searched to find terminal (“tty”) names. 


SEE ALSO 

kill(l), nice(l). 


BUGS 

Things can change while ps is running; the picture it gives is only a close approximation to reality. Some 
data printed for defunct processes are irrelevant. 
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NAME 

ptx - permuted index 
SYNOPSIS 

ptx [ options ] [ input [ output ] ] 

DESCRIPTION 

Ptx generates the file output that can be processed with a text formatter to produce a permuted index of file 
input (standard input and output default). It has three phases: the first does the permutation, generating one 
line for each keyword in an input line. The keyword is rotated to the front. The permuted file is then 
sorted. Finally, the sorted lines are rotated so the keyword comes at the middle of each line. Ptx output is 
in the form: 

.xx "tail" "before keyword" "keyword and after" "head" 

where .xx is assumed to be an nroff or troff( 1) macro provided by the user, or provided by the mptx{5) 
macro package. The before keyword and keyword and after fields incorporate as much of the line as will fit 
around the keyword when it is printed. Tail and head, at least one of which is always the empty string, are 
wrapped-around pieces small enough to fit in the unused space at the opposite end of the line. 

The following options can be applied: 

-f Fold upper and lower case letters for sorting. 

-t Prepare the output for the phototypesetter. 

-w n Use the next argument, n, as the length of the output line. The default line length is 72 char¬ 

acters for nroff and 100 for troff. 

-g n Use the next argument, n, as the number of characters that ptx will reserve in its calculations 

for each gap among the four parts of the line as finally printed. The default gap is 3. 

-o only Use as keywords only the words given in the only file. 

-i ignore Do not use as keywords any words given in the ignore file. If the -i and -o options are miss¬ 

ing, use /usr/Iib/eign as the ignore file. 

-b break Use the characters in the break file to separate words. Tab, new-line, and space characters are 
always used as break characters. 

-r Take any leading non-blank characters of each input line to be a reference identifier (as to a 

page or chapter), separate from the text of the line. Attach that identifier as a 5th field on each 
output line. 

The index for this manual was generated using ptx. 

FILES 

/bin/sort 

/usr/lib/eign 

/usr/lib/tmac/tmac.ptx 

SEE ALSO 

nroffd), troff(l), mm(5), mptx(5). 

BUGS 

Line length counts do not account for overstriking or proportional spacing. 

Lines that contain tildes (~) are botched, because ptx uses that character internally. 
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NAME 

pwd - working directory name 

SYNOPSIS 

pwd 

DESCRIPTION 

Pwd prints the path name of the working (current) directory. 

SEE ALSO 

cd(l). 

DIAGNOSTICS 

“Cannot open and “Read error in indicate possible file system trouble and should be referred to a 
UNIX System programming counselor. 
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NAME 

ratfor - rational Fortran dialect 
SYNOPSIS 

ratfor [ options ] [ files ] 

DESCRIPTION 

Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor provides control flow 
constructs essentially identical to those in C: 

statement grouping: 

{ statement; statement; statement } 

decision-making: 

if (condition) statement [ else statement ] 
switch (integer value) { 

case integer: statement 

[ default: ] statement 

} 

loops: 

while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break 

next 

and some syntactic sugar to make programs easier to read and write: 
free form input: 

multiple statements/line; automatic continuation 

comments: 

# this is a comment. 

translation of relationals: 

>, >=, etc., become .GT., .GE., etc. 

return expression to caller from function: 
return (expression) 

define: 

define name replacement 

include: 

include file 

The option -h causes quoted strings to be turned into 27H constructs. The -C option copies comments to 
the output and attempts to format it neatly. Normally, continuation lines are marked with a & in column 1; 
the option -6x makes the continuation character x and places it in column 6. 

Ratfor is best used with /77(l). 

SEE ALSO 

efl(l), f77(l). 

B. W. Kernighan and P. J. Plauger, Software Tools , Addison-Wesley, 1976. 
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NAME 

regcmp - regular expression compile 

SYNOPSIS 

regcmp [ - ] files 

DESCRIPTION 

Regcmp , in most cases, precludes the need for calling regcmp{ 3X) from C programs. This saves on both 
execution time and program size. The command regcmp compiles the regular expressions in file and places 
the output in file.\. If the - option is used, the output will be placed in file.c. The format of entries in file is 
a name (C variable) followed by one or more blanks followed by a regular expression enclosed in double 
quotes. The output of regcmp is C source code. Compiled regular expressions are represented as extern 
char vectors. File i files may thus be included into C programs, or file.c files may be compiled and later 
loaded. In the C program which uses the regcmp output, regex(abc,line) will apply the regular expression 
named abc to line. Diagnostics are self-explanatory. 

EXAMPLES 

name "([A-Za-z] [A-Za-zO-9 J *)$0" 

telno "\({0,1 }([2-9][01][l-9])$0\){0,l} *" 

"([2—9] [0—9] {2})$1[ —]{0,1}" 

"([0-9]{4})$2" 

In the C program that uses the regcmp output, 
regex(telno, line, area, exch, rest) 
will apply the regular expression named telno to line. 

SEE ALSO 

regcmp(3X). 
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NAME 

rjestat - RJE status report and interactive status console 
SYNOPSIS 

rjestat [ host ]... [ -s host ] [ -c host and ]... 

DESCRIPTION 

Rjestat provides a method of determining the status of an RJE link and of simulating an IBM remote console 
(with UNIX System features added). When invoked with no arguments, rjestat reports the current status of 
all the RJE links connected to to the UNIX System. The options are: 

host Print the status of the line to host. Host is the pseudonym for a particular IBM system. It can 

be any name that corresponds to one in the first column of the RJE configuration file. 

-s host After all the arguments have been processed, start an interactive status console to host. 

-chost and Interpret and as if it were entered in status console mode to host. See below for the proper for¬ 
mat of and. 

In status console mode, rjestat prompts with the host pseudonym followed by : whenever it is ready to 
accept a command. Commands are terminated with a new-line. A line that begins with ! is sent to the 
UNIX System shell for execution. A line that begins with the letter q terminates rjestat. All other input 
lines are assumed to have the form: 

ibmcmd [ redirect ] 

Ibmcmd is any IBM JES or HASP command. Only the super-user or rje login can send commands other 
than display or inquiry commands. Redirect is a pipeline or a redirection to a file (e.g., “> file” or “ | grep 
...”). The IBM response is written to the pipeline or file. If redirect is not present, the response is written 
to the standard output of rjestat. 

An interrupt signal (DEL or BREAK) will cancel the command in progress and cause rjestat to return to the 
command input mode. 

EXAMPLE 

The following command reports the status of all the card readers attached to host A, remote 5. JES2 is 
assumed. 

rjestat -cA '$du,rmt5 I grep RD' 

DIAGNOSTICS 

The message “RJE error: ...” indicates that rjestat found an inconsistency in the RJE system. This may be 
transient but should be reported to the site administrator. 

FILES 

/usr/rje/lines RJE configuration file 

resp host response file that exists in the RJE subsystem directory (e.g., /usr/rjel). 

SEE ALSO 

send(lC). 

OS/VS2 HASP II Version 4 Operator’s Guide, IBM SRL #GC27-6993. 

Operator’s Library: OS/VS2 Reference (JES2), IBM SRL #GC38-0210. 
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NAME 

rm, rmdir - remove files or directories 

SYNOPSIS 

rm [ -fri ] file ... 

rmdir dir... 

DESCRIPTION 

Rm removes the entries for one or more files from a directory. If an entry was the last link to the file, the 
file is destroyed. Removal of a file requires write permission in its directory, but neither read nor write per¬ 
mission on the file itself. 

If a file has no write permission and the standard input is a terminal, its permissions are printed and a line is 
read from the standard input. If that line begins with y the file is deleted, otherwise the file remains. No 
questions are asked when the -f option is given or if the standard input is not a terminal. 

If a designated file is a directory, an error comment is printed unless the optional argument -r has been 
used. In that case, rm recursively deletes the entire contents of the specified directory, and the directory 
itself. 

If the -i (interactive) option is in effect, rm asks whether to delete each file, and, under -r, whether to 
examine each directory. 

Rmdir removes entries for the named directories, which must be empty. 

SEE ALSO 

unlink(2). 

DIAGNOSTICS 

Generally self-explanatory. It is forbidden to remove the file .. merely to avoid the antisocial consequences 
of inadvertently doing something like: 

rm -r .* 


Page 1 



RMDEL(l) 


RMDEL(l) 


NAME 

rmdel - remove a delta from an SCCS file 

SYNOPSIS 

rmdel -rSID files 

DESCRIPTION 

Rmdel removes the delta specified by the SID from each named SCCS file. The delta to be removed must be 
the newest (most recent) delta in its branch in the delta chain of each named SCCS file. In addition, the 
specified must not be that of a version being edited for the purpose of making a delta (i. e., if a p-file (see 
get( 1)) exists for the named SCCS file, the specified must not appear in any entry of the p-file). 

If a directory is named, rmdel behaves as though each file in the directory were specified as a named file, 
except that non-SCCS files (last component of the path name does not begin with s.) and unreadable files 
are silently ignored. If a name of - is given, the standard input is read; each line of the standard input is 
taken to be the name of an SCCS file to be processed; non-SCCS files and unreadable files are silently 
ignored. 

The exact permissions necessary to remove a delta are documented in the Source Code Control System 
User’s Guide. Simply stated, they are either (1) if you make a delta you can remove it; or (2) if you own 
the file and directory you can remove a delta. 

FILES 

x-file (see delta (1)) 

z-file (see delta (1)) 

SEE ALSO 

delta(l), get(l), help(l), prs(l), sccsfile(4). 

Source Code Control System User’s Guide in the UNIX System User’s Guide. 

DIAGNOSTICS 

Use help) 1) for explanations. 
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NAME 

sact - print current SCCS file editing activity 

SYNOPSIS 

sact files 

DESCRIPTION 

Sact informs the user of any impending deltas to a named SCCS file. This situation occurs when get( 1) 
with the -e option has been previously executed without a subsequent execution of delta( 1). If a directory 
is named on the command line, sact behaves as though each file in the directory were specified as a named 
file, except that non-SCCS files and unreadable files are silently ignored. If a name of - is given, the stan¬ 
dard input is read with each line being taken as the name of an SCCS file to be processed. 

The output for each named file consists of five fields separated by spaces. 

Field 1 specifies the SID of a delta that currently exists in the SCCS file to which changes will 

be made to make the new delta. 

Field 2 specifies the SID for the new delta to be created. 

Field 3 contains the logname of the user who will make the delta (i.e. executed a get for edit¬ 

ing). 

Field 4 contains the date that get -e was executed. 

Field 5 contains the time that get -e was executed. 

SEE ALSO 

delta(l), get(l), unget(l). 

DIAGNOSTICS 

Use help( 1) for explanations. 
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NAME 

sadp - disk access profiler 
SYNOPSIS 

sadp [ -th | [ -d device [ -drive] ] s [ n ] 

DESCRIPTION 

Sadp reports disk access location and seek distance, in tabular or histogram form. It samples disk activity 
once every second during an interval of s seconds. This is done repeatedly if n is specified. Cylinder usage 
and disk distance are recorded in units of eight cylinders. 

Valid values of device are rp06, rm05, and disk. Drive specifies the disk drives and it may be: 

a drive number in the range supported by device , 
two numbers separated by a minus (indicating an inclusive range), 
or 

a list of drive numbers separated by commas. 

Up to eight disk drives may be reported. The -d option may be omitted, if only one device is present. 

The -t flag causes the data to be reported in tabular form. The -h flag produces a histogram on the printer 
of the data. Default is -t. 

EXAMPLE 

The command: 

sadp -d rp06 -0 900 4 

will generate 4 tabular reports, each describing cylinder usage and seek distance of rp06 disk drive 0 during 
a 15 minute interval. 

FILES 

/dev/kmem 
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NAME 

sag - system activity graph 

SYNOPSIS 

sag [ options ] 

DESCRIPTION 

Sag graphically displays the system activity data stored in a binary data file by a previous sar( 1) run. Any 
of the sar data items may be plotted singly, or in combination; as cross plots, or versus time. Simple arith¬ 
metic combinations of data may be specified. Sag invokes sar and finds the desired data by string-matching 
the data column header (run sar to see what’s available). These options are passed thru to sar: 

-s time Select data later than time in the form hh [:mm]. Default is 08:00. 

-e time Select data up to time. Default is 18:00. 

-i sec Select data at intervals as close as possible to sec seconds. 

—{file Use file as the data source for sar. Default is the current daily data file /usr/adm/sa/saaW. 

Other options: 

-T term Produce output suitable for terminal term. See tplot{ 1G) for known terminals. If term is vpr, 
output is processed by vpr -p and queued to a Versatec printer. Default for term is $TERM. 

-x spec x axis specification with spec in the form: 

"name [op name]... [lo hi]" 

-y spec y axis specification with spec in the same form as above. 

Name is either a string that will match a column header in the sar report, with an optional device name in 
square brackets, e.g., r+w/s[dsk-l], or an integer value. Op is + -* or / surrounded by blanks. Up to five 
names may be specified. Parentheses are not recognized. Contrary to custom, + and - have precedence 
over * and /. Evaluation is left to right. Thus A / A + B * 100 is evaluated (A/(A+B))*100, and 
A + B/ C + Dis (A+B)/(C+D). Lo and hi are optional numeric scale limits. If unspecified, they are 
deduced from the data. 

A single spec is permitted for the x axis. If unspecified, time is used. Up to 5 spec s separated by ; may be 
given for -y. Enclose the -x and -y arguments in " " if blanks or \<CR> are included. The -y default is: 

-y "%usr 0 100; %usr + %sys 0 100; %usr + %sys + %wio 0 100" 

EXAMPLES 

To see today’s CPU utilization: 
sag 

To see activity over 15 minutes of all disk drives: 

TS='date +%H:%M' 
sar -o tempfile 60 15 
TE=' date +%H:%M' 

sag -f tempfile -s $TS -e $TE -y "r+w/s[dsk]" 

FILES 

/usr/adm/sa/saoW daily data file for day dd. 

SEE ALSO 

sar(l), tplot(lG). 
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NAME 

sar - system activity reporter 

SYNOPSIS 

sar [ -ubdycwaqvmA ] [ -o file ] t [ n ] 

sar [ -ubdycwaqvmA ] [ -s time ] [ -e time ] [ -i sec ] [ -f file ] 

DESCRIPTION 

Sar, in the first instance, samples cumulative activity counters in the operating system at n intervals of t sec¬ 
onds. If the -o option is specified, it saves the samples in file in binary format. The default value of n is 1. 
In the second instance, with no sampling interval specified, sar extracts data from a previously recorded 
file, either the one specified by -f option or, by default, the standard system activity daily data file 
/usr/adni/sa/saoW for the current day dd. The starting and ending times of the report can be bounded via 
the -s and -e time arguments of the form hh[:mm[:ss]]. The -i option selects records at sec second inter¬ 
vals. Otherwise, all intervals found in the data file are reported. 

In either case, subsets of data to be printed are specified by option: 

-u Report CPU utilization (the default): 

%usr, %sys, %wio, %idle - portion of time running in user mode, running in system mode, idle with 
some process waiting for block I/O, and otherwise idle. 

-b Report buffer activity: 

bread/s, bwrit/s - transfers per second of data between system buffers and disk or other block 
devices; 

lread/s, lwrit/s - accesses of system buffers; 

%rcache, %wcache - cache hit ratios, e. g., 1 - bread/lread; 
pread/s, pwrit/s - transfers via raw (physical) device mechanism. 

-d Report activity for each block device, e. g., disk or tape drive: 

%busy, avque - portion of time device was busy servicing a transfer request, average number of 
requests outstanding during that time; 

r+w/s, blks/s - number of data transfers from or to device, number of bytes transferred in 512 byte 
units; 

avwait, avserv - average time in ms. that transfer requests wait idly on queue, and average time to be 
serviced (which for disks includes seek, rotational latency and data transfer times). 

-y Report TTY device activity: 

rawch/s, canch/s, outch/s - input character rate, input character rate processed by canon, output char¬ 
acter rate; 

rcvin/s, xmtin/s, mdmin/s - receive, transmit and modem interrupt rates. 

-c Report system calls: 

scall/s - system calls of all types; 

sread/s, swrit/s, fork/s, exec/s - specific system calls; 

rchar/s, wchar/s - characters transferred by read and write system calls. 

-w Report system swapping and switching activity: 

swpin/s, swpot/s, bswin/s, bswot/s - number of transfers and number of 512 byte units transferred for 
swapins (including initial loading of some programs) and swapouts; 
pswch/s - process switches. 

-a Report use of file access system routines: 
iget/s, namei/s, dirblk/s. 

-q Report average queue length while occupied, and % of time occupied: 
runq-sz, %runocc - run queue of processes in memory and runnable; 
swpq-sz, %swpocc - swap queue of processes swapped out but ready to run. 

-v Report status of text, process, inode and file tables: 

text-sz, proc-sz, inod-sz, file-sz - entries/size for each table, evaluated once at sampling point; 
text-ov, proc-ov, inod-ov, file-ov - overflows occurring between sampling points. 
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-m Report message and semaphore activities: 

msg/s, sema/s - primitives per second. 

-A Report all data. Equivalent to -udqbwcayvm. 

EXAMPLES 

To see today’s CPU activity so far: 
sar 

To watch CPU activity evolve for 10 minutes and save data: 
sar -o temp 60 10 

To later review disk and tape activity from that period: 
sar -d -f temp 

FILES 

/usr/adm/sa/sac/t/ daily data file, where dd are digits representing the day of the month. 
SEE ALSO 

sag(lG). 

sar(lM) in the UNIX System Administrator’s Manual. 
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NAME 

scat - concatenate and print files on synchronous printer 
SYNOPSIS 

scat [ -u ] [ -s ] file ... 

DESCRIPTION 

Scat reads each file in sequence and writes it on the standard output, which is assumed to be a synchronous 
printer device. Thus: 

scat file > /dev/spO 

prints the file, and: 

cat filel file2 > /dev/spO 

concatenates filel and file2 and places the result on the printer. 

If no input file is given, or if the argument - is encountered, scat reads from the standard input file. Output 
is buffered in 512-byte blocks unless the -u option is specified. The -s option makes scat silent about 
non-existent files. 

SEE ALSO 

cp(l), pr(l), stty(l). 

WARNINGS 

Scat uses synchronous printers in line mode with the wrap around option enabled. This means that the 
maximum line length is 79 characters; longer lines will be wrapped back to the beginning of the next line 
each time the end of a printer line is reached. 
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NAME 

see - C compiler for stand-alone programs 
SYNOPSIS 

see [ +[ lib ] ] [ option ] ... [ file ] ... 

DESCRIPTION 

See prepares the named files for stand-alone execution. The option and file arguments may be anything 
that can legally be used with the cc command; it should be noted, though, that the -p (profiling) option, as 
well as any object module that contains system calls, will cause the executable not to run. 

Sec defines the compiler constant, STANDALONE, so that sections of C programs may be compiled condi¬ 
tionally when the executable will be run stand-alone. 

The first argument specifies an auxiliary library that defines the device configuration of the PDP-11 com¬ 
puter for which the stand-alone executable is being prepared. Lib may be one of the following: 

A RP04/05/06 disk and TU16 magnetic tape, or equivalent on the PDP-11 plus RM05 and RM80 

disks, and TU78 and TSl 1 tapes, or equivalent on the VAX 

B RKl 1/RK05 disk, RPl 1/RP03 disk, and TMl 1/TU16 magnetic tape, or equivalent 

If no +lib argument is specified, +A is assumed. If the + argument is specified alone, no configuration 
library is loaded unless the user supplies his own. 

FILES 

/lib/crt2.o execution start-off 

/usr/lib/lib2.a stand-alone library 

/usr/lib/lib2A.a + A configuration library (PDP-11 only) 

/usr/lib/lib2B.a +B configuration library (PDP-11 only) 

SEE ALSO 

cc(l), ld( 1), a.out(4). 
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NAME 

sccsdiff - compare two versions of an SCCS file 
SYNOPSIS 

sccsdiff -rSIDl -rSID2 [-p] [-sn] files 
DESCRIPTION 

Sccsdiff compares two versions of an SCCS file and generates the differences between the two versions. 
Any number of SCCS files may be specified, but arguments apply to all files. 

-r SID? S1D1 and SID2 specify the deltas of an SCCS file that are to be compared. Versions are 

passed to bdiff(l) in the order given. 

-p pipe output for each file through pr( 1). 

-sn n is the file segment size that bdiff will pass to diff( 1). This is useful when diff fails 

due to a high system load. 

FILES 

/tmp/get????? Temporary files 
SEE ALSO 

bdifffl), get(l), help(l), pr(l). 

Source Code Control System UNIX System User’s Guide. 

DIAGNOSTICS 

“file: No differences” If the two versions are the same. 

Use help( 1) for explanations. 
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NAME 

sdb - symbolic debugger 
SYNOPSIS 

sdb [-w] [-W] [ objfil [ corfil [ directory ] ] ] 

DESCRIPTION 

Sdb is a symbolic debugger which can be used with C and F77 programs. It may be used to examine their 
object files and core files and to provide a controlled environment for their execution. 

Objfil is normally an executable program file which has been compiled with the -g (debug) option; if it has 
not been compiled with the -g option, or if it is not an executable file, the symbolic capabilities of sdb will 
be limited, but the file can still be examined and the program debugged. The default for objfil is a.out. 
Corfil is assumed to be a core image file produced after executing objfil ; the default for corfil is core. The 
core file need not be present. A - in place of corfil will force sdb to ignore any core image file. Source 
files used in constructing objfil must be in directory to be located. 

It is useful to know that at any time there is a current line and current file. If corfil exists then they are ini¬ 
tially set to the line and file containing the source statement at which the process terminated. Otherwise, 
they are set to the first line in mainQ. The current line and file may be changed with the source file exami¬ 
nation commands. 

By default, warnings are provided if the source files used in producing objfil cannot be found, or are newer 
than objfil. This checking feature and the accompanying warnings may be disabled by the use of the -W 
flag. 

Names of variables are written just as they are in C or F77. Variables local to a procedure may be accessed 
using the form procedure‘.variable. If no procedure name is given, the procedure containing the current 
line is used by default. 

It is also possible to refer to structure members as variable .member, pointers to structure members as 
variable—>member and array elements as variable [number]. Pointers may be dereferenced by using the 
form pointer[ 0], Combinations of these forms may also be used. F77 common variables may be referenced 
by using the name of the common block instead of the structure name. Blank common variables may be 
named by the form .variable. A number may be used in place of a structure variable name, in which case 
the number is viewed as the address of the structure, and the template used for the structure is that of the 
last structure referenced by sdb. An unqualified structure variable may also be used with various com¬ 
mands. Generally, sdb will interpret a structure as a set of variables. Thus, sdb will display the values of 
all the elements of a structure when it is requested to display a structure. An exception to this interpretation 
occurs when displaying variable addresses. An entire structure does have an address, and it is this value 
sdb displays, not the addresses of individual elements. 

Elements of a multidimensional array may be referenced as variable[number][number]..., or as 
variable\number,number,...]. In place of number, the form number’,number may be used to indicate a 
range of values, * may be used to indicate all legitimate values for that subscript, or subscripts may be 
omitted entirely if they are the last subscripts and the full range of values is desired. As with structures, sdb 
displays all the values of an array or of the section of an array if trailing subscripts are omitted. It displays 
only the address of the array itself or of the section specified by the user if subscripts are omitted. A multi¬ 
dimensional parameter in an F77 program cannot be displayed as an array, but it is actually a pointer, 
whose value is the location of the array. The array itself can be accessed symbolically from the calling 
function. 

A particular instance of a variable on the stack may be referenced by using the form 
procedure ‘.variable,number. All the variations mentioned in naming variables may be used. Number is the 
occurrence of the specified procedure on the stack, counting the top, or most current, as the first. If no pro¬ 
cedure is specified, the procedure currently executing is used by default. 

It is also possible to specify a variable by its address. All forms of integer constants which are valid in C 
may be used, so that addresses may be input in decimal, octal or hexadecimal. 
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Line numbers in the source program are referred to as file-name'.number or procedure'.number. In either 
case the number is relative to the beginning of the file. If no procedure or file name is given, the current file 
is used by default. If no number is given, the first line of the named procedure or file is used. 

While a process is running under sdb all addresses refer to the executing program; otherwise they refer to 
objfil or corfil. An initial argument of -w permits overwriting locations in objfil. 

Addresses. 

The address in a file associated with a written address is determined by a mapping associated with that file. 
Each mapping is represented by two triples ( bl, el, fl) and (b2, e2,J2) and the file address corresponding 
to a written address is calculated as follows: 

bl address<el 

file address =address+fl-bl 
otherwise 

b2 address<e2 

file address =address +f2-b2, 

otherwise, the requested address is not legal. In some cases (e.g. for programs with separated I and D 
space) the two segments for a file may overlap. 

The initial setting of both mappings is suitable for normal a.out and core files. If either file is not of the 
kind expected then, for that file, bl is set to 0, el is set to the maximum file size, and/7 is set to 0; in this 
way the whole file can be examined with no address translation. 

In order for sdb to be used on large files, all appropriate values are kept as signed 32 bit integers. 

Commands. 

The commands for examining data in the program are: 
t Print a stack trace of the terminated or halted program. 

T Print the top line of the stack trace. 
variable/clm 

Print the value of variable according to length / and format m. A numeric count c indicates that a 
region of memory, beginning at the address implied by variable, is to be displayed. The length 
specifiers are: 

b one byte 

h two bytes (half word) 

1 four bytes (long word) 

Legal values for m are: 

c character 

d decimal 

u decimal, unsigned 

o octal 

x hexadecimal 

f 32 bit single precision floating point 

g 64 bit double precision floating point 

s Assume variable is a string pointer and print characters starting at the address 

pointed to by the variable. 

a Print characters starting at the variable's address. This format may not be used 

with register variables, 
p pointer to procedure 

i disassemble machine-language instruction with addresses printed numerically and 

symbolically. 
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I disassemble machine-language instruction with addresses just printed numerically. 

The length specifiers are only effective with the formats c, d, u, o and x. Any of the specifiers, c, l, 
and m, may be omitted. If all are omitted, sdb choses a length and a format suitable for the variable’s 
type as declared in the program. If m is specified, then this format is used for displaying the variable. 
A length specifier determines the output length of the value to be displayed, sometimes resulting in 
truncation. A count specifier c tells sdb to display that many units of memory, beginning at the 
address of variable. The number of bytes in one such unit of memory is determined by the length 
specifier /, or if no length is given, by the size associated with the variable. If a count specifier is 
used for the s or a command then that many characters are printed. Otherwise successive characters 
are printed until either a null byte is reached or 128 characters are printed. The last variable may be 
redisplayed with the command ./. 

The sh( 1) metacharacters * and ? may be used within procedure and variable names, providing a lim¬ 
ited form of pattern matching. If no procedure name is given, variables local to the current procedure 
and global variables are matched, while if a procedure name is specified then only variables local to 
that procedure are matched. To match only global variables, the form : pattern is used. 

linenumberllm 
variable :llm 

Print the value at the address from a.out or I space given by linenumber or variable (procedure 
name), according to the format Im. The default format is ‘i’. 

variable=lm 

linenumber=lm 

number=lm 

Print the address of variable or linenumber, or the value of number , in the format specified by Im. If 
no format is given, then lx is used. The last variant of this command provides a convenient way to 
convert between decimal, octal and hexadecimal. 

variable lvalue 

Set variable to the given value. The value may be a number, a character constant or a variable. The 
value must be well defined; expressions which produce more than one value, such as structures, are 
not allowed. Character constants are denoted ’ character. Numbers are viewed as integers unless a 
decimal point or exponent is used. In this case, they are treated as having the type double. Registers 
are viewed as integers. The variable may be an expression which indicates more than one variable, 
such as an array or structure name. If the address of a variable is given, it is regarded as the address 
of a variable of type int. C conventions are used in any type conversions necessary to perform the 
indicated assignment. 

x Print the machine registers and the current machine-language instruction. 

X Print the current machine-language instruction. 

The commands for examining source files are; 

e procedure 
e file-name 
e directory/ 
e directory file-name 

The first two forms set the current file to the hie containing procedure or to file-name. The current 
line is set to the first line in the named procedure or hie. Source hies are assumed to be in directory. 
The default is the current working directory. The latter two forms change the value of directory. If 
no procedure, hie name, or directory is given, the current procedure name and hie name are reported. 

/regular expression / 

Search forward from the current line for a line containing a string matching regular expression as in 
ed( 1). The trailing / may be elided. 
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?regular expression ? 

Search backward from the current line for a line containing a string matching regular expression as 
in ed{\). The trailing ? may be elided. 

p Print the current line. 

z Print the current line followed by the next 9 lines. Set the current line to the last line printed. 

w Window. Print the 10 lines around the current line. 

number 

Set the current line to the given line number. Print the new current line. 
count+ 

Advance the current line by count lines. Print the new current line. 
count— 

Retreat the current line by count lines. Print the new current line. 

The commands for controlling the execution of the source program are: 

count r args 
count R 

Run the program with the given arguments. The r command with no arguments reuses the previous 
arguments to the program while the R command runs the program with no arguments. An argument 
beginning with < or > causes redirection for the standard input or output respectively. If count is 
given, it specifies the number of breakpoints to be ignored. 

linenumber c count 
linenumber C count 

Continue after a breakpoint or interrupt. If count is given, it specifies the number of breakpoints to 
be ignored. C continues with the signal which caused the program to stop reactivated and c ignores 
it. If a linenumber is specified then a temporary breakpoint is placed at the line and execution is con¬ 
tinued. The breakpoint is deleted when the command finishes. 

linenumber g count 

Continue after a breakpoint with execution resumed at the given line. If count is given, it specifies 
the number of breakpoints to be ignored. 

s count 
S count 

Single step the program through count lines. If no count is given then the program is run for one line. 
S is equivalent to s except it steps through procedure calls. 


I Single step by one machine-language instruction. I steps with the signal which caused the program 
to stop reactivated and i ignores it. 

variable $m count 
address :m count 

Single step (as with s) until the specified location is modified with a new value. If count is omitted, it 
is effectively infinity. Variable must be accessible from the current procedure. Since this command 
is done by software, it can be very slow. 

level v 

Toggle verbose mode, for use when single stepping with S, s or m. If level is omitted, then just the 
current source file and/or subroutine name is printed when either changes. If level is 1 or greater, 
each C source line is printed before it is executed; if level is 2 or greater, each assembler statement is 
also printed. A v turns verbose mode off if it is on for any level. 

k Kill the program being debugged. 
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procedure(arg 1 ,arg2,...) 
procedure(argl,arg2,...)/m 

Execute the named procedure with the given arguments. Arguments can be integer, character or 
string constants or names of variables accessible from the current procedure. The second form causes 
the value returned by the procedure to be printed according to format m. If no format is given, it 
defaults to d. 

linenumber b commands 

Set a breakpoint at the given line. If a procedure name without a line number is given (e.g. “proc:”), 
a breakpoint is placed at the first line in the procedure even if it was not compiled with the -g option. 
If no linenumber is given, a breakpoint is placed at the current line. If no commands are given, exe¬ 
cution stops just before the breakpoint and control is returned to sdb. Otherwise the commands are 
executed when the breakpoint is encountered and execution continues. Multiple commands are 
specified by separating them with semicolons. If k is used as a command to execute at a breakpoint, 
control returns to sdb, instead of continuing execution. 

B Print a list of the currently active breakpoints. 

linenumber d 

Delete a breakpoint at the given line. If no linenumber is given then the breakpoints are deleted inter¬ 
actively: Each breakpoint location is printed and a line is read from the standard input. If the line 
begins with a y or d then the breakpoint is deleted. 

D Delete all breakpoints. 

1 Print the last executed line. 

linenumber a 

Announce. If linenumber is of the form proc'.number, the command effectively does a linenumber b 
1. If linenumber is of the form proc:, the command effectively does a proc: b T. 

Miscellaneous commands: 

!command 

The command is interpreted by sh( 1). 

new-line 

If the previous command printed a source line then advance the current line by one line and print the 
new current line. If the previous command displayed a memory location then display the next mem¬ 
ory location. 

control-D 

Scroll. Print the next 10 lines of instructions, source or data depending on which was printed last. 

< filename 

Read commands from filename until the end of file is reached, and then continue to accept commands 
from standard input. When sdb is told to display a variable by a command in such a file, the variable 
name is displayed along with the value. This command may not be nested; < may not appear as a 
command in a file. 

M Print the address maps. 

M [?/][*] b e f 

Record new values for the address map. The arguments ? and / specify the text and data maps 
respectively. The first segment, (bl, el, fl), is changed unless * is specified, in which case the sec¬ 
ond segment, (bl, el, fl), of the mapping is changed. If fewer than three values are given, the 
remaining map parameters are left unchanged. 

" string 

Print the given string. The C escape sequences of the form \character are recognized, where 
character is a nonnumeric character. 


Page 5 



SDB(l) 


(not on PDP-11) 


SDB(l) 


q Exit the debugger. 

The following commands also exist and are intended only for debugging the debugger: 

V Print the version number. 

Q Print a list of procedures and files being debugged. 

Y Toggle debug output. 

FILES 

a.out 

core 

SEE ALSO 

cc( 1), f77(l), sh( 1), a.out(4), core(4). 

WARNINGS 

On the VAX-11/780, C variables are identified internally with an underscore prepended. User variables 
which differ by only an initial underscore cannot be distinguished, as sdb recognizes both internal and 
external names. 

Data which are stored in text sections are indistinguishable from functions. 

Line number information in optimized functions is unreliable, and some information may be missing. 

BUGS 

If a procedure is called when the program is not stopped at a breakpoint (such as when a core image is 
being debugged), all variables are initialized before the procedure is started. This makes it impossible to 
use a procedure which formats data from a core image. 

The default type for printing F77 parameters is incorrect. Their address is printed instead of their value. 

Tracebacks containing F77 subprograms with multiple entry points may print too many arguments in the 
wrong order, but their values are correct. 

The range of an F77 array subscript is assumed to be 1 to n, where n is the dimension corresponding to that 
subscript. This is only significant when the user omits a subscript, or uses * to indicate the full range. 
There is no problem in general with arrays having subscripts whose lower bounds are not 1. 

On the 3B20S there is no hardware trace mode and single stepping is implemented by setting pseudo break¬ 
points where possible. This is slow. 

The entry point to an optimized function cannot be found on the 3B20S. Setting a breakpoint at the begin¬ 
ning of an optimized function may cause the middle of some instruction within the function to be overwrit¬ 
ten. This problem can be circumvented by disassembling the first few instructions of the function, and 
manually setting a breakpoint at the first instruction after the stack pointer is adjusted. 
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NAME 

sdiff - side-by-side difference program 

SYNOPSIS 

sdiff | options ... ] filel file2 

DESCRIPTION 

Sdiff uses the output of diff{ 1) to produce a side-by-side listing of two files indicating those lines that are 
different. Each line of the two files is printed with a blank gutter between them if the lines are identical, a < 
in the gutter if the line only exists in filel , a > in the gutter if the line only exists in file2, and a I for lines 
that are different. 

For example: 


x I y 

a a 

b < 

c < 

d d 

> c 


The following options exist: 

-w n Use the next argument, n, as the width of the output line. The default line length is 130 char¬ 

acters. 

Only print the left side of any lines that are identical. 

Do not print identical lines. 

Use the next argument, output, as the name of a third file that is created as a user controlled 
merging of filel and file2. Identical lines of filel and file2 are copied to output. Sets of dif¬ 
ferences, as produced by diff(l), are printed; where a set of differences share a common gutter 
character. After printing each set of differences, sdiff prompts the user with a % and waits 
for one of the following user-typed commands: 

1 append the left column to the output file 

r append the right column to the output file 

s turn on silent mode; do not print identical lines 

v turn off silent mode 

el call the editor with the left column 

e r call the editor with the right column 

e b call the editor with the concatenation of left and right 

e call the editor with a zero length file 

q exit from the program 

On exit from the editor, the resulting file is concatenated on the end of the output file. 

SEE ALSO 

diff(l), ed(l). 


-1 

-s 

-o output 
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NAME 

se - screen editor for video terminals 
SYNOPSIS 

se [-T[term]] [-ifile] [-ofile] [-s] [file] 

DESCRIPTION 

Se is an interactive screen editor for use on asynchronous, ASCII CRT terminals. If the file argument is 
given, se will read the file into its buffer so that it can be edited. If no file is specified, the buffer will be 
empty and there will be no current file name. 

Options to se are: 

-T Causes se to print a list of the terminal types it understands and exit immediately, ignoring all 

other options. 

-Tterm Specifies the terminal type being used. If no -T option is specified, se will check the environ¬ 
ment variables SETERM and TERM (in that order) to determine the terminal type specified 
(the first non-null value it finds is the one used). If no terminal type is specified or if the ter¬ 
minal type specified is unknown to se, se will print a diagnostic followed by a list of terminal 
types it understands and then exit. 

-ifile Causes a sequence of se commands to be read from the named file. The file is read to end of 

file. If more than one -i option is given, the files are read in the order specified on the com¬ 
mand line. When all -i options have been processed, commands are read from the standard 
input. A maximum of five files may be specified. 

-ofile Causes a copy of all commands given to this invocation of se to be placed in file. This file 

may then be used with the -i option. 

-s Reduce the number of messages printed on the status line. This is intended for the expert 

user. 

Other than the order of multiple -i options, the order of the options and the filename on the command line 
is not important. 

During editing, se displays the contents of the file on the screen. As the file is edited, the screen is updated 
to reflect changes made in the file contents. If the entire contents of the file will not fit on the screen, se dis¬ 
plays a portion of it. The limits of the file are indicated on the screen by the TOP OF FILE and BOTTOM 
OF FILE messages. 

The top line of the display is used for a status line. The status line contains (from left to right): the last 
command entered (or being entered), error messages and the name of the file being edited. 

The current position in the file is indicated by the position of the cursor on the screen. The cursor can be 
moved to different file positions by cursor movement commands or find commands. The cursor is not 
restricted to text already present. If text is inserted or overwritten to the right of the end of the line, the line 
will be padded with blanks. 

Se operates in command mode: each character typed is interpreted as part of an se command. As each 
command is recognized, the appropriate action is performed. To add new text to the file, the insert com¬ 
mand is used. During insert, characters typed are interpreted as text to be added to the file. The text is 
added before the current cursor position. For example, if the cursor is positioned on the first r in the word 
edr-formatter and the insert command is given, typing ito and ending the insert yields editor-formatter. 

COMMAND SYNTAX 

Most se commands are of the form: 

[count] [text-identifier] command 

The count is an optional field, an integer between 1 and 32,767. The default value for count is one. The 
optional text-identifier specifies the block of text of interest. Valid text-identifiers are described below; the 
default value for text-identifiers is dependent on the command. If more than one count or text-identifier is 
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used, all but the last will be ignored. Commands are specified below. 


TEXT IDENTIFIERS 

The valid text-identifiers ( text-id) are: 


Text-id 

Text Represented 

. 

Character 

w 

Word 

F 

File 

1 

Line 

S (or s) 

Screen 

e 

Previously defined region 

/ 

Region found by last find command 


In general, a text-id block is identified as that in which the cursor is positioned. A text-id may also be 
identified by a cursor positioned on the white space following the text-id. 

CURSOR KEYS 

The cursor keys on the terminal keyboard are used to move the cursor around the screen and through the 
file. For terminals with no cursor keys, the ctrl+z, ctrl+x, ctrl+c, ctrl+v keys may be used instead of , 4-, 
T and —» respectively. 

NOTATION 

In the list of se commands below, the following notations apply: 

[ ] items within brackets are optional 

{ } one of the items within the braces must be used 

text-id identifies a block of text 

chars any string of characters 

position-cursor a sequence of cursor-moves or find commands (see below) 

TEXT COMMANDS 

Commands longer than one character (for example, READ) may be invoked by typing an unique initial sub¬ 
string followed by a RETURN (newline). If the substring is not unique the RETURN is ignored. The 
BREAK key causes se to stop its current action and return to its command level. 

cursor moves 

[count] cursor key Move the cursor count lines up (T) or down (4-) or count characters to the 

left (<—) or the right (-4). Screen scroll will occur if the top or bottom of 
screen is encountered. The cursor will wrap at line beginning and end as 
expected. 

[count] [text-id] cursor key Move the cursor the specified amount of text-id blocks. If the text-id is 

character (.) (default), the action is the same as for plain cursor key use (see 
above). For all other text-ids , 4— means beginning of. —> means end of T 
means previous, and 4- means next. For example, S4- means go to the next 
screen. 

The space-bar moves the cursor one character to the right (equivalent to 

The RETURN key moves the cursor to the beginning of the next line. 

The TAB key moves the cursor to the next tab position (set every 8 
columns). 

For terminals that have a HOME key, it moves the cursor to the top left 
corner of the screen (equivalent to S«—). 


space-bar 

RETURN 

TAB 

HOME 
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Define Region 

b [position-cursor] ctrl+d Define an arbitrary linear region. Any command that changes the file being 

edited will cause the current region to be undefined. 

Copy text 

[count] [text-id] c [position-cursor] ctrl+d 

Copy text-id block (default is one character) at new cursor position. 

Delete text 

[count] [text-id] d Delete text-id block (default is one character). 

Refresh document display 

DISPLAY Rewrites display from the file. Useful to restore contents of screen from 

the effects of line noise etc. 

Edit file 

EDIT [filename] { ctrl+d, RETURN } 

Start editing the specified file. If no file name has been specified, use the 
current file. If the contents of the current file have been altered since the 
last WRITE command, the user is first queried as to whether to save those 
changes. 

Find string occurrence 

[text-id] f chars { ctrl+d, RETURN } 

Search text-id (default is entire file) for chars and position cursor there. 
The cursor is not moved if chars are not found. The chars are interpreted 
as a regular expression (see regexp( 5)). 

Find all and execute command automatically 

[count] [text-id] g chars { ctrl+d, RETURN } command 

Search text-id (default is entire file) for all occurrences of chars; position- 
cursor at first occurrence and execute command. Continue to next occur¬ 
rence and apply the same command, and so on. The command may not be 
another global command. The chars are interpreted as a regular expression 
(see regexp(5)). 

Find all and execute command interactively 

[count] [text-id] G chars { ctrl+d, RETURN } command 

Search text-id (default is entire file) for first occurrence of chars; position- 
cursor at first occurrence and wait for command', execute command and 
continue to next occurrence where a new command may be input, and so 
on. The command may not be another global command. The chars are 
interpreted as a regular expression (see regexpi 5)). 

Insert text at the current cursor position. If the text-id is 1, a blank line is 
inserted and the cursor positioned at the beginning of that line. Use of 
cursor-keys (no preceding count or text-id) positions the cursor at the next 
character to be inserted. The back-space key will cause the previous char¬ 
acter to be deleted. 

Move text 

[count] [text-id] m [position-cursor] ctrl+d 

Reposition text-id block (default is one character) at new position. It is an 
error if the new position is within the text to be moved. 

Overwrite text 

o chars ctrl+d Performs one-to-one character replacement beginning at cursor position. 

Use of cursor-keys (no preceding count or text-id) positions the cursor at 


Insert text 

[text-id] i chars ctrl+d 
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the next character to be overwritten. The back-space key will cause the 
previous character to be deleted. 

Leave the editor 

q Exits from se. If the contents of the current file have been altered since the 

last WRITE command, the user is first queried as whether to save those 
changes. 

Get text 

READ [filename] { ctrl+d, RETURN } 

Insert text from filename at cursor position. If no filename is specified, the 
current filename is used. The cursor position is unchanged. 

Replace text 

[count] [text-id] r chars ctrl+d Replace text-id block (default is one character) with text. 

Undo last command 

UNDO Undoes last text-modifying command. An UNDO may not be undone. 

Save text 

[count] [text-id] WRITE [filename] { ctrl+d, RETURN } 

Save text from text-id (default is entire file) in the named file. If filename 
is not specified, text is saved in the file currently being edited. Note that 
existing text in the file is replaced. 

Process through the UNIX System 

[count] [text-id] X UNIX System command { ctrl+d, RETURN } 

Passes text-id block (default is no text) to the UNIX System-command as 
standard input and replaces text-id block with the standard output from the 
UNIX System-command. 

Request help 

? Display a listing of available se text-ids, commands and their syntax. 

Escape from editor 

[count] [text-id] ! UNIX System command { ctrl+d, RETURN } 

If the text-id or count is specified, it is given as standard input to the UNIX 
System command. Otherwise, standard input is the same as for se. No 
changes are made to the file being edited. 

Repeat last command 

" Ditto repeats the last command. This means the command plus preceding 

text-id and count. 

Go to line 

N # Move to line N, where N is an integer between 1 and 32,767. 

Erase input 

@ Cause se to ignore any partially typed command (including count, 

modifier, and multi-character command). 

TERMINAL REQUIREMENTS 

Se can run on any terminal with suitable cursor addressing. In order to use cursor keys, they must emit char¬ 
acters to the host computer. Performance may be degraded if the terminal does not have: 

- character insert and delete 

- line insert and delete 

- erase to end of line and page 

If the terminal type specified is not suitable (i.e. it has no cursor addressing), se prints a diagnostic and exits 

immediately. 
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The environment variable TERMINFO modifies the search for the specified terminal type in the terminal 
description file. If present, it should contain one of two kinds of values: 

- an alternate file name for the terminal description file (in this case, the first character must be a /). This 
file will be used to search for a description of the specified terminal instead of the default terminal 
description file. 

- the description for a specific terminal (this should be the entry from the terminal description file with 
the escaped newlines removed). This description will be treated as though it had been prepended to the 
default terminal description file. Using TERMINFO in this manner allows the redefinition of a specific 
terminal description or the inclusion of a description for a terminal that is not included in the default ter¬ 
minal description file. 

If the description contained in TERMINFO is that of the terminal to be used with se , start-up time for se can 
be reduced considerably since the terminal description file need not be searched. 

FILES 

/tmp/se# temporary; # is the process number. 

/tmp/sei# record of keystrokes; # is the process number. 

/usr/lib/se.term terminal description file 

DIAGNOSTICS 

Error messages are displayed on the message line on the screen during editing. 

WARNING 

Regular expressions span more than one line, thus abc.*xyz may match the entire file. 

Some terminals need persuasion to make the cursor keys emit characters. For example, HP2621 cursor 
keys only emit characters when the function labels are displayed and the SHIFT key is held down and the 
cursor key struck. 

SEE ALSO 

regexp(5). 
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NAME 

sed - stream editor 

SYNOPSIS 

sed [ -n ] [ -e script ] [ -f sfile ] [ files ] 

DESCRIPTION 

Sed copies the named files (standard input default) to the standard output, edited according to a script of 
commands. The -f option causes the script to be taken from file sfile ; these options accumulate. If there is 
just one -e option and no -f options, the flag -e may be omitted. The -n option suppresses the default out¬ 
put. A script consists of editing commands, one per line, of the following form: 

[ address [ , address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input into a pattern space ( unless there is something left 
after a D command), applies in sequence all commands whose addresses select that pattern space, and at 
the end of the script copies the pattern space to the standard output (except under -n) and deletes the pattern 
space. 

Some of the commands use a hold space to save all or part of the pattern space for subsequent retrieval. 

An address is either a decimal number that counts input lines cumulatively across files, a $ that addresses 
the last line of input, or a context address, i.e., a / regular expression / in the style of ed( I) modified thus: 

In a context address, the construction \?regular expression? , where ? is any character, is identical 
to / regular expression/. Note that in the context address \xabc\xdefx, the second x stands 
for itself, so that the regular expression is abcxdef. 

The escape sequence \n matches a new-line embedded in the pattern space. 

A period . matches any character except the terminal new-line of the pattern space. 

A command line with no addresses selects every pattern space. 

A command line with one address selects each pattern space that matches the address. 

A command line with two addresses selects the inclusive range from the first pattern space that 
matches the first address through the next pattern space that matches the second. (If the 
second address is a number less than or equal to the line number first selected, only one 
line is selected.) Thereafter the process is repeated, looking again for the first address. 

Editing commands can be applied only to non-selected pattern spaces by use of the negation function ! 
(below). 

In the following list of functions the maximum number of permissible addresses for each function is indi¬ 
cated in parentheses. 

The text argument consists of one or more lines, all but the last of which end with \ to hide the new-line. 
Backslashes in text are treated like backslashes in the replacement string of an s command, and may be 
used to protect initial blanks and tabs against the stripping that is done on every script line. The rfile or 
wfile argument must terminate the command line and must be preceded by exactly one blank. Each wfile is 
created before processing begins. There can be at most 10 distinct wfile arguments. 

d)a\ 

text Append. Place text on the output before reading the next input line. 

(2) b label Branch to the : command bearing the label. If label is empty, branch to the end of the script. 

(2)c\ 

text Change. Delete the pattern space. With 0 or 1 address or at the end of a 2-address range, place 

text on the output. Start the next cycle. 

(2) d Delete the pattern space. Start the next cycle. 

(2) D Delete the initial segment of the pattern space through the first new-line. Start the next cycle. 

(2) g Replace the contents of the pattern space by the contents of the hold space. 

(2) G Append the contents of the hold space to the pattern space. 

(2) h Replace the contents of the hold space by the contents of the pattern space. 
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(2) H Append the contents of the pattern space to the hold space. 

(1) i\ 

text Insert. Place text on the standard output. 

(2) 1 List the pattern space on the standard output in an unambiguous form. Non-printing characters 

are spelled in two-digit ASCII and long lines are folded. 

(2) n Copy the pattern space to the standard output. Replace the pattern space with the next line of 

input. 

(2) N Append the next line of input to the pattern space with an embedded new-line. (The current 

line number changes.) 

(2) p Print. Copy the pattern space to the standard output. 

(2) P Copy the initial segment of the pattern space through the first new-line to the standard output. 

(1) q Quit. Branch to the end of the script. Do not start a new cycle. 

(2) r rfile Read the contents of rfile. Place them on the output before reading the next input line. 

(2) s /regular expression/replacement/flags 

Substitute the replacement string for instances of the regular expression in the pattern space. 
Any character may be used instead of /. For a fuller description see ed( 1). Flags is zero or 
more of: 

g Global. Substitute for all nonoverlapping instances of the regular expression 

rather than just the first one. 

p Print the pattern space if a replacement was made, 

w wfile Write. Append the pattern space to wfile if a replacement was made. 

Test. Branch to the : command bearing the label if any substitutions have been made since the 
most recent reading of an input line or execution of a t. If label is empty, branch to the end of 
the script. 

Write. Append the pattern space to wfile. 

Exchange the contents of the pattern and hold spaces. 

(2) y /string 1 /string2/ 

Transform. Replace all occurrences of characters in string1 with the corresponding character 
in string2. The lengths of string1 and string2 must be equal. 

(2)! function 

Don’t. Apply the function (or group, if function is { ) only to lines not selected by the 
address(es). 

(0): label This command does nothing; it bears a label for b and t commands to branch to. 

(1) = Place the current line number on the standard output as a line. 

(2) { Execute the following commands through a matching } only when the pattern space is selected. 

(0) An empty command is ignored. 

SEE ALSO 

awk(l), ed(l), grep(l). 


(2) t label 

(2) w wfile 
(2)x 
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NAME 

send, gath - gather files and/or submit RJE jobs 

SYNOPSIS 

gath [—ih] file ... 

send argument... 

DESCRIPTION 

Gath 

Gath concatenates the named files and writes them to the standard output. Tabs are expanded into spaces 
according to the format specification for each file (see/spec(4)). The size limit and margin parameters of a 
format specification are also respected. Non-graphic characters other than tabs are identified by a diagnos¬ 
tic message and excised. The output of gath contains no tabs unless the -h flag is set, in which case the 
output is written with standard tabs (every eighth column). 

Any line of any of the files which begins with ~ is interpreted by gath as a control line. A line beginning 
” (tilde,space) specifies a sequence of files to be included at that point. A line beginning ~! specifies a 
UNIX System command; that command is executed, and its output replaces the ~! line in the gath output. 

Setting the -i flag prevents control lines from being interpreted and causes them to be output literally. 

A file name of - at any point refers to standard input, and a control line consisting of is a logical EOF. 
Keywords may be defined by specifying a replacement string which is to be substituted for each occurrence 
of the keyword. Input may be collected directly from the terminal, with several alternatives for prompting. 
In fact, all of the special arguments and flags recognized by the send command are also recognized and 
treated identically by gath. Several of them only make sense in the context of submitting an RJE job. 

Send 

Send is a command-level interface to the RJE subsystems. It allows the user to collect input from various 
sources in order to create a run stream consisting of card images, and submit this run stream for transmis¬ 
sion to an IBM host computer. Output from the IBM system may be returned to the user in either ASCII text 
form or EBCDIC punch format (see pnch (4)). 

Possible sources of input to send are: ordinary files, standard input, the terminal, and the output of a com¬ 
mand or shell file. Each source of input is treated as a virtual file, and no distinction is made based upon its 
origin. Typical input is an ASCII text file of the sort that is created by the editor ed( 1). An optional format 
specification appearing in the first line of a file (see fspec(4)) determines the settings according to which 
tabs are expanded into spaces. In addition, lines that begin with ~ are normally interpreted as commands 
controlling the execution of send. They may be used to set or reset flags, to define keyword substitutions, 
and to open new sources of input in the midst of the current source. Other text lines are translated one-for- 
one into card images of the run stream. 

The run stream that results from this collection is treated as one job by the RJE subsystems. Send prints the 
card count of the run stream, and the queuer that is invoked prints the name of the temporary file that holds 
the job while it is awaiting transmission. The initial card of a job submitted to a host must have a // in the 
first column. Any cards preceding this card will be excised. If a host computer is not specified before the 
first card of the runstream is ready to be sent, send will select a reasonable default. All cards beginning 
with /*$ will be excised from the runstream, because they are HASP command cards. 

The arguments that send accepts are described below. An argument is interpreted according to the first pat¬ 
tern that it matches. Preceding a character with \ causes it to loose any special meaning it might otherwise 
have when matching against an argument pattern. 

. Close the current source. 

- Open standard input as a new source. 

+ Open the terminal as a new source. 

:spec: Establish a default format specification for included sources, 

e.g., :m6t-12: 
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•.message 

Print message on the terminal. 

—•.prompt 

Open standard input and, if it is a terminal, print prompt. 

+:prompt 

Open the terminal and print prompt. 

-flags 

Set the specified flags, which are described below. 

+flags 

Reset the specified flags. 

=flags 

Restore the specified flags to their state at the previous level. 

!command 

Execute the specified UNIX System command via the one-line shell, with input 
redirected to /dev/null as a default. Open the standard output of the command 


as a new source. 

%line 

Collect contiguous arguments of this form and write them as consecutive lines 
to a temporary file; then have the file executed by the shell. Open the standard 
output of the shell as a new source. 

@ directory 

The current directory for the send process is changed to directory. The origi¬ 
nal directory will be restored at the end of the current source. 

~comment 

Ignore this argument. 

? ‘.keyword 

Prompt for a definition of keyword from the terminal unless keyword has an 
existing definition. 

? keyword =~xx 

Define the keyword as a two digit hexadecimal character code unless it already 
has a non null replacement. 

? keyword =string 

Define the keyword in terms of a replacement string unless it already has a non 
null replacement. 

=:keyword 

Prompt for a definition of keyword from the terminal. 

keyword="xx 

Define keyword as a two-digit hexadecimal character code. 

keyword=string 

Define keyword in terms of a replacement string. 

host 

The host machine that the job should be submitted to. It can be any name that 
corresponds to one in the first column of the RJE configuration file 
(/usr/rje/lines). 

file-name 

Open the specified file as a new source of input. 


When commands are executed via $ or ! the shell environment (see environ{ 5)) will contain the values of 
all send keywords that begin with $ and have the syntax of a shell variable. 

The flags recognized by send are described in terms of the special processing that occurs when they are 
set: 

-1 List card images on standard output. EBCDIC characters are translated back to ASCII. 

-q Do not output card images. 

-f Do not fold lower case to upper. 

-t Trace progress on diagnostic output, by announcing the opening of input sources. 

-k Ignore the keywords that are active at the previous level and erase any keyword definitions that 

have been made at the current level. 

-r Process included sources in raw mode; pack arbitrary 8-bit bytes one per column (80 columns 
per card) until an EOF. 

-i Do not interpret control lines in included sources; treat them as text. 

-s Make keyword substitutions before detecting and interpreting control lines. 
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-y Suppress error diagnostics and submit job anyway. 

-g Gather mode, qualifying -1 flag; list text lines before converting them to card images. 

-h Write listing with standard tabs. 

-p Prompt with * when taking input from the terminal. 

-m When input returns to the terminal from a lower level, repeat the prompt, if any. 

-a Make -k flag propagate to included sources, thereby protecting them from keyword substitu¬ 
tions. 

-c List control lines on diagnostic output. 

-d Extend the current set of keyword definitions by adding those active at the end of included 
sources. 

-x This flag guarantees that the job will be transmitted in the order of submission (relative to other 
jobs sent with this flag). 

Control lines are input lines that begin with “. In the default mode +ir, they are interpreted as com¬ 
mands to send. Normally they are detected immediately and read literally. The -s flag forces key¬ 
word substitutions to be made before control lines are intercepted and interpreted. This can lead to 
unexpected results if a control line uses a keyword which is defined within an immediately preceding 
~$ sequence. Arguments appearing in control lines are handled exactly like the command arguments to 
send, except that they are processed at a nested level of input. 

The two possible formats for a control line are; “'argument” and argumentIn the first case, 
where the ~ is not followed by a space, the remainder of the line is taken as a single argument to send. 
In the second case, the line is parsed to obtain a sequence of arguments delimited by spaces. In this 
case the quotes ' and " may be employed to pass embedded spaces. 

The interpretation of the argument . is chosen so that an input line consisting of is treated as a logi¬ 
cal EOF. The following example illustrates some of the above conventions: 

send - 
argument... 

This sequence of three lines is equivalent to the command synopsis at the beginning of this descrip¬ 
tion. In fact, the - is not even required. By convention, the send command reads standard input if no 
other input source is specified. Send may therefore be employed as a filter with side-effects. 

The execution of the send command is controlled at each instant by a current environment, which 
includes the format specification for the input source, a default format specification for included 
sources, the settings of the mode flags, and the active set of keyword definitions. This environment 
can be altered dynamically. When a control line opens a new source of input, the current environment 
is pushed onto a stack, to be restored when input resumes from the old source. The initial format 
specification for the new source is taken from the first line of the file. If none is provided, the estab¬ 
lished default is used or, in its absence, standard tabs. The initial mode settings and active keywords 
are copied from the old environment. Changes made while processing the new source will not affect 
the environment of the old source, with one exception: if -d mode is set in the old environment, the 
old keyword context will be augmented by those definitions that are active at the end of the new 
source. 

When send first begins execution, all mode flags are reset, and the values of the shell environment 
variables become the initial values for keywords of the same name with a $ prefixed. 

The initial reset state for all mode flags is the + state. In general, special processing associated with a 
mode N is invoked by flag -N and is revoked by flag +N. Most mode settings have an immediate 
effect on the processing of the current source. Exceptions to this are the -r and -i flags, which apply 
only to included source, causing it to be processed in an uninterpreted manner. 
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A keyword is an arbitrary 8-bit ASCII string for which a replacement has been defined. The replace¬ 
ment may be another string or the hexadecimal code for a single 8-bit byte. At any instant, a given set 
of keyword definitions is active. Input text lines are scanned, in one pass from left to right, and long¬ 
est matches are attempted between substrings of the line and the active set of keywords. Characters 
that do not match are output, subject to folding and the standard translation. Keywords are replaced by 
the specified hexadecimal code or replacement string, which is then output character by character. The 
expansion of tabs and length checking, according to the format specification of an input source, are 
delayed until substitutions have been made in a line. 

All of the keywords definitions made in the current source may be deleted by setting the -k flag. It 
then becomes possible to reuse them. Setting the -k flag also causes keyword definitions active at the 
previous source level to be ignored. Setting the +k flag causes keywords at the previous level to be 
ignored but does not delete the definitions made at the current level. The =k argument reactivates the 
definitions of the previous level. 

When keywords are redefined, the previous definition at the same level of source input is lost, however 
the definition at the previous level is only hidden, to be reactivated upon return to that level unless a 
-d flag causes the current definition to be retained. 

Conditional prompts for keywords, ?:A,/p which have already been defined at some higher level to be 
null or have a replacement will simply cause the definitions to be copied down to the current level; 
new definitions will not be solicited. 

Keyword substitution is an elementary macro facility that is easily explained and that appears useful 
enough to warrant its inclusion in the send command. More complex replacements are the function of 
a general macro processor (m4( 1), perhaps). To reduce the overhead of string comparison, it is recom¬ 
mended that keywords be chosen so that their initial characters are unusual. For example, let them all 
be upper case. 

Send performs two types of error checking on input text lines. Firstly, only ASCII graphics and tabs 
are permitted in input text. Secondly, the length of a text line, after substitutions have been made, may 
not exceed 80 bytes. The length of each line may be additionally constrained by a size parameter in 
the format specification for an input source. Diagnostic output provides the location of each erroneous 
line, by line number and input source, a description of the error, and the card image that results. Other 
routine errors that are announced are the inability to open or write files, and abnormal exits from the 
shell. Normally, the occurrence of any error causes send, before invoking the queuer, to prompt for 
positive affirmation that the suspect run stream should be submitted. 

Before submitting a job to a host, send translates 8-bit ASCII characters into their EBCDIC equivalents. 
The conversion for 8-bit ASCII characters in the octal range 040-176 is based on the character set 
described in “Appendix H" of IBM System/370 Principles of Operation (IBM SRL GA22-7000). 
Each 8-bit ASCII character in the range 040-377 possesses an EBCDIC equivalent into which it is 
mapped, with five exceptions: ~ into —i, 0345 into ~, 0325 into <t, 0313 into I , 0177 (DEL) is illegal. In 
listings requested from send and in printed output returned by the subsystem, the reverse translation is 
made with the qualification that EBCDIC characters that do not have valid 8-bit ASCII equivalents are 
translated into 

Additional control over the translation process is afforded by the -f flag and hexadecimal character 
codes. As a default, send folds lower-case letters into upper case. Setting the -f flag inhibits any fold¬ 
ing. Non-standard character codes are obtained as a special case of keyword substitution. 

SEE ALSO 

m4(l), rjestat(lC), sh(l), fspec(4), pnch(4), ascii(5), environ(5). 

UNIX Remote Job Entry User’s Guide in the UNIX System User’s Guide . 

BUGS 

Standard input is read in blocks, and unused bytes are returned via lseek(2). If standard input is a pipe, 
multiple arguments of the form - and prompt should not be used, nor should the logical EOF (".). 
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NAME 

sh, rsh - shell, the standard/restricted command programming language 
SYNOPSIS 

sh [ -ceiknrstuvx ] [ args ] 
rsh [ -ceiknrstuvx ] [ args ] 

DESCRIPTION 

Sh is a command programming language that executes commands read from a terminal or a file. Rsh is a 
restricted version of the standard command interpreter sh; it is used to set up login names and execution 
environments whose capabilities are more controlled than those of the standard shell. See Invocation 
below for the meaning of arguments to the shell. 

Commands. 

A simple-command is a sequence of non-blank words separated by blanks (a blank is a tab or a space). 
The first word specifies the name of the command to be executed. Except as specified below, the remaining 
words are passed as arguments to the invoked command. The command name is passed as argument 0 (see 
exec{2)). The value of a simple-command is its exit status if it terminates normally, or (octal) !{){)+status if 
it terminates abnormally (see signal(2) for a list of status values). 

A pipeline is a sequence of one or more commands separated by I (or, for historical compatibility, by ~). 
The standard output of each command but the last is connected by a pipe (2) to the standard input of the 
next command. Each command is run as a separate process; the shell waits for the last command to termi¬ 
nate. 

A list is a sequence of one or more pipelines separated by ;, &, &&, or I |, and optionally terminated by ; 
or &. Of these four symbols, ; and & have equal precedence, which is lower than that of && and I I. The 
symbols && and I I also have equal precedence. A semicolon (;) causes sequential execution of the pre¬ 
ceding pipeline; an ampersand (&) causes asynchronous execution of the preceding pipeline (i.e., the shell 
does not wait for that pipeline to finish). The symbol && (II) causes the list following it to be executed 
only if the preceding pipeline returns a zero (non-zero) exit status. An arbitrary number of new-lines may 
appear in a list, instead of semicolons, to delimit commands. 

A command is either a simple-command or one of the following. Unless otherwise stated, the value 
returned by a command is that of the last simple-command executed in the command. 

for name [ in word ... ] do list done 

Each time a for command is executed, name is set to the next word taken from the in word list. If 
in word ... is omitted, then the for command executes the do list once for each positional param¬ 
eter that is set (see Parameter Substitution below). Execution ends when there are no more words 
in the list. 

case word in [ pattern [ I pattern ] ...) list ;; ] ... esac 

A case command executes the list associated with the first pattern that matches word. The form 
of the patterns is the same as that used for file-name generation (see File Name Generation 
below). 

if list then list [ elif list then list ]... [ else list ] fi 

The list following if is executed and, if it returns a zero exit status, the list following the first then 
is executed. Otherwise, the list following elif is executed and, if its value is zero, the list follow¬ 
ing the next then is executed. Failing that, the else list is executed. If no else list or then list is 
executed, then the if command returns a zero exit status, 
while list do list done 

A while command repeatedly executes the while list and, if the exit status of the last command in 
the list is zero, executes the do list; otherwise the loop terminates. If no commands in the do list 
are executed, then the while command returns a zero exit status; until may be used in place of 
while to negate the loop termination test. 

(list) 

Execute list in a sub-shell. 
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{list;} 

list is simply executed. 

The following words are only recognized as the first word of a command and when not quoted: 

if then else elif fi case esac for while until do done { } 

Comments. 

A word beginning with # causes that word and all the following characters up to a new-line to be ignored. 

Command Substitution. 

The standard output from a command enclosed in a pair of grave accents (' ' ) may be used as part or all of 
a word; trailing new-lines are removed. 

Parameter Substitution. 

The character $ is used to introduce substitutable parameters. Positional parameters may be assigned val¬ 
ues by set. Variables may be set by writing: 

name=value [ name=value ]... 

Pattern-matching is not performed on value. 

${ parameter } 

A parameter is a sequence of letters, digits, or underscores (a name), a digit, or any of the charac¬ 
ters *, @, #, ?, -, $, and !. The value, if any, of the parameter is substituted. The braces are 
required only when parameter is followed by a letter, digit, or underscore that is not to be inter¬ 
preted as part of its name. A name must begin with a letter or underscore. If parameter is a digit 
then it is a positional parameter. If parameter is * or @, then all the positional parameters, start¬ 
ing with $1, are substituted (separated by spaces). Parameter $0 is set from argument zero when 
the shell is invoked. 

^{parameter:—word } 

If parameter is set and is non-null then substitute its value; otherwise substitute word. 

${/;« rame te r:=word } 

If parameter is not set or is null then set it to word ; the value of the parameter is then substituted. 
Positional parameters may not be assigned to in this way. 

%{parameter: ? word } 

If parameter is set and is non-null then substitute its value; otherwise, print word and exit from 
the shell. If word is omitted, then the message “parameter null or not set” is printed. 

${pa rame te r:+word } 

If parameter is set and is non-null then substitute word ; otherwise substitute nothing. 

In the above, word is not evaluated unless it is to be used as the substituted string, so that, in the following 
example, pwd is executed only if d is not set or is null: 

echo ${d:- v pwd v } 

If the colon (:) is omitted from the above expressions, then the shell only checks whether parameter is set 
or not. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal. 

- Flags supplied to the shell on invocation or by the set command. 

? The decimal value returned by the last synchronously executed command. 

$ The process number of this shell. 

! The process number of the last background command invoked. 

The following parameters are used by the shell: 

HOME The default argument (home directory) for the cd command. 

PATH The search path for commands (see Execution below). The user may not change PATH if 
executing under rsh. 
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CDPATH 

The search path for the cd command. 

MAIL If this variable is set to the name of a mail file, then the shell informs the user of the 
arrival of mail in the specified file. 

PS1 Primary prompt string, by default “$ ”, 

PS2 Secondary prompt string, by default “> ”, 

IFS Internal field separators, normally space, tab, and new-line. 

The shell gives default values to PATH, PS1, PS2, and IFS, while HOME and MAIL are not set at all by the 
shell (although HOME is set by login (1)). 

Blank Interpretation. 

After parameter and command substitution, the results of substitution are scanned for internal field separa¬ 
tor characters (those found in IFS) and split into distinct arguments where such characters are found. 
Explicit null arguments (""or ' ') are retained. Implicit null arguments (those resulting from parameters 
that have no values) are removed. 

File Name Generation. 

Following substitution, each command word is scanned for the characters *, ?, and [. If one of these char¬ 
acters appears then the word is regarded as a pattern. The word is replaced with alphabetically sorted file 
names that match the pattern. If no file name is found that matches the pattern, then the word is left 
unchanged. The character . at the start of a file name or immediately following a /, as well as the character / 
itself, must be matched explicitly. 

* Matches any string, including the null string. 

? Matches any single character. 

[... ] Matches any one of the enclosed characters. A pair of characters separated by - matches 
any character lexically between the pair, inclusive. If the first character following the 
opening "[ " is a “!” then any character not enclosed is matched. 

Quoting. 

The following characters have a special meaning to the shell and cause termination of a word unless 
quoted: 

;&()!*<> new-line space tab 

A character may be quoted (i.e., made to stand for itself) by preceding it with a Y The pair \new-line is 
ignored. All characters enclosed between a pair of single quote marks (' '), except a single quote, are 
quoted. Inside double quote marks (" "), parameter and command substitution occurs and \ quotes the char¬ 
acters Y ', ", and $. "$*" is equivalent to "$1 $2 ...", whereas "$@" is equivalent to "$ 1 " "$2"_ 

Prompting. 

When used interactively, the shell prompts with the value of PS1 before reading a command. If at any time 
a new-line is typed and further input is needed to complete a command, then the secondary prompt (i.e., the 
value of PS2) is issued. 


Input/Output. 

Before a command is executed, its input and output may be redirected using a special notation interpreted 
by the shell. The following may appear anywhere in a simple-command or may precede or follow a 
command and are not passed on to the invoked command; substitution occurs before word or digit is used: 


<word 

>word 

»word 

<[-]word 


Use file word as standard input (file descriptor 0). 

Use file word as standard output (file descriptor 1). If the file does not exist then it is cre¬ 
ated; otherwise, it is truncated to zero length. 

Use file word as standard output. If the file exists then output is appended to it (by first 
seeking to the end-of-file); otherwise, the file is created. 

The shell input is read up to a line that is the same as word , or to an end-of-file. The 
resulting document becomes the standard input. If any character of word is quoted, then 
no interpretation is placed upon the characters of the document; otherwise, parameter and 
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command substitution occurs, (unescaped) \new-line is ignored, and \ must be used to 
quote the characters \, $, ', and the first character of word. If - is appended to «, then all 
leading tabs are stripped from word and from the document. 

<&digit The standard input is duplicated from file descriptor digit (see dup{ 2)). Similarly for the 

standard output using >. 

<&- The standard input is closed. Similarly for the standard output using >. 

If one of the above is preceded by a digit, then the file descriptor created is that specified by the digit 
(instead of the default 0 or 1). For example: 

... 2>&1 

creates file descriptor 2 that is a duplicate of file descriptor 1. 

If a command is followed by & then the default standard input for the command is the empty file /dev/null. 
Otherwise, the environment for the execution of a command contains the file descriptors of the invoking 
shell as modified by input/output specifications. 

Redirection of output is not allowed in the restricted shell. 

Environment. 

The environment (see environ ( 5)) is a list of name-value pairs that is passed to an executed program in the 
same way as a normal argument list. The shell interacts with the environment in several ways. On invoca¬ 
tion, the shell scans the environment and creates a parameter for each name found, giving it the correspond¬ 
ing value. Executed commands inherit the same environment. If the user modifies the values of these 
parameters or creates new ones, none of these affects the environment unless the export command is used 
to bind the shell's parameter to the environment. The environment seen by any executed command is thus 
composed of any unmodified name-value pairs originally inherited by the shell, plus any modifications or 
additions, all of which must be noted in export commands. 

The environment for any simple-command may be augmented by prefixing it with one or more assignments 
to parameters. Thus: 

TERM=450 cmd args and 

(export TERM; TERM=450; cmd args) 

are equivalent (as far as the above execution of cmd is concerned). 

If the -k flag is set, all keyword arguments are placed in the environment, even if they occur after the com¬ 
mand name. The following first prints a=b c and then c: 

echo a=b c 
set -k 
echo a=b c 

Signals. 

The INTERRUPT and QUIT signals for an invoked command are ignored if the command is followed by &; 
otherwise signals have the values inherited by the shell from its parent, with the exception of signal 11 (but 
see also the trap command below). 

Execution. 

Each time a command is executed, the above substitutions are carried out. Except for the Special 
Commands listed below, a new process is created and an attempt is made to execute the command via 
exec (2). 

The shell parameter PATH defines the search path for the directory containing the command. Alternative 
directory names are separated by a colon (:). The default path is :/bin:/usr/bin (specifying the current 
directory, /bin, and /usr/bin, in that order). Note that the current directory is specified by a null path name, 
which can appear immediately after the equal sign or between the colon delimiters anywhere else in the 
path list. If the command name contains a / then the search path is not used; such commands will not be 
executed by the restricted shell. Otherwise, each directory in the path is searched for an executable file. If 
the file has execute permission but is not an a.out file, it is assumed to be a file containing shell commands. 
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A sub-shell (i.e., a separate process) is spawned to read it. A parenthesized command is also executed in a 
sub-shell. 

Special Commands. 

The following commands are executed in the shell process and, except as specified, no input/output redirec¬ 
tion is permitted for such commands: 

: No effect; the command does nothing. A zero exit code is returned. 

. file Read and execute commands from file and return. The search path specified by PATH is used to 

find the directory containing file. 

break [ n ] 

Exit from the enclosing for or while loop, if any. If n is specified then break n levels. 

continue [ n ] 

Resume the next iteration of the enclosing for or while loop. If n is specified then resume at the 
n -th enclosing loop, 
cd [ arg ] 

Change the current directory to arg. The shell parameter HOME is the default arg. The shell 
parameter CDPATH defines the search path for the directory containing arg. Alternative directory 
names are separated by a colon (:). The default path is <null> (specifying the current directory). 
Note that the current directory is specified by a null path name, which can appear immediately 
after the equal sign or between the colon delimiters anywhere else in the path list. If arg begins 
with a / then the search path is not used. Otherwise, each directory in the path is searched for arg. 
The cd command may not be executed by rsh. 
eval [ arg ... ] 

The arguments are read as input to the shell and the resulting command(s) executed, 
exec [ arg ... ] 

The command specified by the arguments is executed in place of this shell without creating a new 
process. Input/output arguments may appear and, if no other arguments are given, cause the shell 
input/output to be modified, 
exit [ n ] 

Causes a shell to exit with the exit status specified by n. If n is omitted then the exit status is that 
of the last command executed (an end-of-file will also cause the shell to exit.) 
export [ name ... ] 

The given names are marked for automatic export to the environment of subsequently-executed 
commands. If no arguments are given, then a list of all names that are exported in this shell is 
printed. 

newgrp [arg ... ] 

Equivalent to exec newgrp arg .... 
read [ name ... ] 

One line is read from the standard input and the first word is assigned to the first name , the second 
word to the second name, etc., with leftover words assigned to the last name. The return code is 0 
unless an end-of-file is encountered, 
readonly [ name ... ] 

The given names are marked readonly and the values of the these names may not be changed by 
subsequent assignment. If no arguments are given, then a list of all readonly names is printed, 
set [ —ekntuvx [ arg ... ] ] 

-e Exit immediately if a command exits with a non-zero exit status. 

-k All keyword arguments are placed in the environment for a command, not just those that 
precede the command name. 

-n Read commands but do not execute them. 

-t Exit after reading and executing one command. 

-u Treat unset variables as an error when substituting. 

-v Print shell input lines as they are read. 

-x Print commands and their arguments as they are executed. 
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— Do not change any of the flags; useful in setting $1 to 

Using + rather than - causes these flags to be turned off. These flags can also be used upon invo¬ 
cation of the shell. The current set of flags may be found in $-. The remaining arguments are 
positional parameters and are assigned, in order, to $1, $2, .... If no arguments are given then the 
values of all names are printed. 

shift [ n ] 

The positional parameters from $n+l ... are renamed $1_ If n is not given, it is assumed to be 

1 . 

test 

Evaluate conditional expressions. See test{ 1) for usage and description. 

times 

Print the accumulated user and system times for processes run from the shell, 
trap [ arg ] [ n ] ... 

arg is a command to be read and executed when the shell receives signal(s) n. (Note that arg is 
scanned once when the trap is set and once when the trap is taken. ) Trap commands are executed 
in order of signal number. Any attempt to set a trap on a signal that was ignored on entry to the 
current shell is ineffective. An attempt to trap on signal 11 (memory fault) produces an error. If 
arg is absent then all trap(s) n are reset to their original values. If arg is the null string then this 
signal is ignored by the shell and by the commands it invokes. If n is 0 then the command arg is 
executed on exit from the shell. The trap command with no arguments prints a list of commands 
associated with each signal number, 
ulimit [ -fp ][ n \ 

imposes a size limit of n 

-f imposes a size limit of n blocks on files written by child processes (files of any size may 
be read). With no argument, the current limit is printed. 

-p changes the pipe size to n (UNIX System/RT only). 

If no option is given, -f is assumed, 
umask [ win ] 

The user file-creation mask is set to win (see wnaskd)). If win is omitted, the current value of the 
mask is printed, 
wait [ n ] 

Wait for the specified process and report its termination status. If n is not given then all currently 
active child processes are waited for and the return code is zero. 

Invocation. 

If the shell is invoked through exec(2) and the first character of argument zero is -, commands are initially 
read from /etc/profile and then from $HOME/.profile, if such files exist. Thereafter, commands are read as 
described below, which is also the case when the shell is invoked as /bin/sh. The flags below are inter¬ 
preted by the shell on invocation only; Note that unless the -c or -s flag is specified, the first argument is 
assumed to be the name of a file containing commands, and the remaining arguments are passed as posi¬ 
tional parameters to that command file: 

-c string If the -c flag is present then commands are read from string. 

-s If the -s flag is present or if no arguments remain then commands are read from the standard 

input. Any remaining arguments specify the positional parameters. Shell output is written to 
file descriptor 2. 

-i If the -i flag is present or if the shell input and output are attached to a terminal, then this shell 

is interactive. In this case TERMINATE is ignored (so that kill 0 does not kill an interactive 
shell) and INTERRUPT is caught and ignored (so that wait is interruptible). In all cases, QUIT 
is ignored by the shell. 

-r If the -r flag is present the shell is a restricted shell. 

The remaining flags and arguments are described under the set command above. 

Rsh Only. 

Rsh is used to set up login names and execution environments whose capabilities are more controlled than 
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those of the standard shell. The actions of rsh are identical to those of sh , except that the following are dis¬ 
allowed: 

changing directory (see cd( 1)), 

setting the value of $PATH, 

specifying path or command names containing /, 

redirecting output (> and »). 

The restrictions above are enforced after .profile is interpreted. 

When a command to be executed is found to be a shell procedure, rsh invokes sh to execute it. Thus, it is 
possible to provide to the end-user shell procedures that have access to the full power of the standard shell, 
while imposing a limited menu of commands; this scheme assumes that the end-user does not have write 
and execute permissions in the same directory. 

The net effect of these rules is that the writer of the .profile has complete control over user actions, by per¬ 
forming guaranteed setup actions and leaving the user in an appropriate directory (probably not the login 
directory). 

The system administrator often sets up a directory of commands (i.e., /usr/rbin) that can be safely invoked 
by rsh. Some systems also provide a restricted editor red. 

EXIT STATUS 

Errors detected by the shell, such as syntax errors, cause the shell to return a non-zero exit status. If the 
shell is being used non-interactively then execution of the shell file is abandoned. Otherwise, the shell 
returns the exit status of the last command executed (see also the exit command above). 

FILES 

/etc/profile 

SHOME/.profile 

/tmp/sh* 

/dev/null 

SEE ALSO 

cd(l), env(l), login(l), newgrp(l), test(l), umask(l), dup(2), exec(2), fork(2), pipe(2), signal(2), ulimit(2), 
umask(2), wait(2), a.out(4), profile(4), environ(5). 

BUGS 

The command readonly (without arguments) produces the same output as the command export. 

If <s is used to provide standard input to an asynchronous process invoked by &, the shell gets mixed up 
about naming the input document; a garbage file /tmp/sh* is created and the shell complains about not 
being able to find that file by another name. 
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NAME 

size - print section sizes of common object files 
SYNOPSIS 

size [— o] [-x] [-V] files 
DESCRIPTION 

The size command produces section size information for each section in the common object files. The size 
of the text, data and bss (uninitialized data) sections are printed along with the total size of the object file. 
If an archive file is input to the size command the information for all archive members is displayed. 

Numbers will be printed in decimal unless either the -o or the -x option is used, in which case they will be 
printed in octal or in hexadecimal, respectively. 

The -V flag will supply the version information on the size command. 

SEE ALSO 

as(l), cc(l), ld( 1), a.out(4), ar(4). 

DIAGNOSTICS 

size: name: cannot open 

if name cannot be read. 

size: name: bad magic 

if name is not an appropriate common object file. 
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NAME 

size - print sizes of object files 

SYNOPSIS 

size [ object... ] 

DESCRIPTION 

Size prints the (decimal) number of bytes required by the text, data, and bss portions, and their sum in octal 
and decimal, of each object-file argument. If no file is specified, a.out is used. 

SEE ALSO 

a.out(4). 
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NAME 

sleep - suspend execution for an interval 

SYNOPSIS 

sleep time 

DESCRIPTION 

Sleep suspends execution for time seconds. It is used to execute a command after a certain amount of time 
as in: 

(sleep 105; command)& 

or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 


SEE ALSO 

alarm(2), sleep(3C). 

BUGS 

Time must be less than 65536 seconds. 
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NAME 

sno - SNOBOL interpreter 

SYNOPSIS 

sno [ files ] 

DESCRIPTION 

Sno is a SNOBOL compiler and interpreter (with slight differences). Sno obtains input from the concatena¬ 
tion of the named files and the standard input. All input through a statement containing the label end is 
considered program and is compiled. The rest is available to syspit. 

Sno differs from SNOBOL in the following ways: 

There are no unanchored searches. To get the same effect: 

a ** b unanchored search for b. 

a *x* b = xc unanchored assignment 

There is no back referencing. 

x = "abc" 

a *x* x is an unanchored search for abc. 

Function declaration is done at compile time by the use of the (non-unique) label define. Execu¬ 
tion of a function call begins at the statement following the define. Functions cannot be defined at 
run time, and the use of the name define is preempted. There is no provision for automatic vari¬ 
ables other than parameters. Examples: 

define f() 
define f(a, b, c) 

All labels except define (even end) must have a non-empty statement. 

Labels, functions and variables must all have distinct names. In particular, the non-empty state¬ 
ment on end cannot merely name a label. 

If start is a label in the program, program execution will start there. If not, execution begins with 
the first executable statement; define is not an executable statement. 

There are no builtin functions. 

Parentheses for arithmetic are not needed. Normal precedence applies. Because of this, the arith¬ 
metic operators / and * must be set off by spaces. 

The right side of assignments must be non-empty. 

Either ' or " may be used for literal quotes. 

The pseudo-variable sysppt is not available. 

SEE ALSO 

awk(l). 

SNOBOL, a String Manipulation Language, by D. J. Farber, R. E. Griswold, and I. P. Polonsky, JACM 11 
(1964), pp. 21-30. 
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NAME 

sort - sort and/or merge files 
SYNOPSIS 

sort [-cmubdfinrtx] [+posl [-pos2]]... [-0 output] [names] 

DESCRIPTION 

Sort sorts lines of all the named files together and writes the result on the standard output. The name - 
means the standard input. If no input files are named, the standard input is sorted. 

The default sort key is an entire line. Default ordering is lexicographic by bytes in machine collating 
sequence. The ordering is affected globally by the following options, one or more of which may appear. 

b Ignore leading blanks (spaces and tabs) in field comparisons. 

d “Dictionary” order: only letters, digits and blanks are significant in comparisons. 

f Fold upper case letters onto lower case. 

i Ignore characters outside the ASCII range 040-0176 in non-numeric comparisons. 

n An initial numeric string, consisting of optional blanks, optional minus sign, and zero or more digits 
with optional decimal point, is sorted by arithmetic value. Option n implies option b. 

r Reverse the sense of comparisons. 

tv “Tab character” separating fields is x. 

The notation +posl -pos2 restricts a sort key to a field beginning at posl and ending just before pos2. 
Posl and pos2 each have the form m.n, optionally followed by one or more of the flags bdfinr, where m 
tells a number of fields to skip from the beginning of the line and 11 tells a number of characters to skip fur¬ 
ther. If any flags are present they override all the global ordering options for this key. If the b option is in 
effect n is counted from the first non-blank in the field; b is attached independently to pos2. A missing .n 
means .0; a missing -pos2 means the end of the line. Under the -tv option, fields are strings separated by 
x; otherwise fields are non-empty non-blank strings separated by blanks. 

When there are multiple sort keys, later keys are compared only after all earlier keys compare equal. Lines 
that otherwise compare equal are ordered with all bytes significant. 

These option arguments are also understood: 

c Check that the input file is sorted according to the ordering rules; give no output unless the file is out 
of sort. 

m Merge only, the input files are already sorted. 

u Suppress all but one in each set of equal lines. Ignored bytes and bytes outside keys do not partici¬ 
pate in this comparison. 

o The next argument is the name of an output file to use instead of the standard output. This file may 
be the same as one of the inputs. 

EXAMPLES 

Print in alphabetical order all the unique spellings in a list of words (capitalized words differ from uncapi¬ 
talized): 

sort -u +0f +0 list 

Print the password file (passwd( 4)) sorted by user ID (the third colon-separated field): 
sort -t: +2n /etc/passwd 

Print the first instance of each month in an already sorted file of (month-day) entries (the options -um with 
just one input file make the choice of a unique representative from a set of equal lines predictable): 

sort -um +0 -1 dates 
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FILES 

/usr/tmp/stm??? 

SEE ALSO 

comm(l), join(l), uniq(l). 

DIAGNOSTICS 

Comments and exits with non-zero status for various trouble conditions and for disorder discovered under 
option -c. 

BUGS 

Very long lines are silently truncated. 
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NAME 

spell, hashmake, spellin, hashcheck - find spelling errors 
SYNOPSIS 

spell [ -v ] [ -b ] [ -x ] [ -1 ] [ +local file ] [ files ] 

/usr/lib/spell/hashmake 
/usr/lib/spell/spellin n 
/usr/lib/spell/hashcheck spelling list 
DESCRIPTION 

Spell collects words from the named files and looks them up in a spelling list. Words that neither occur 
among nor are derivable (by applying certain inflections, prefixes, and/or suffixes) from words in the spel¬ 
ling list are printed on the standard output. If no files are named, words are collected from the standard 
input. 

Spell ignores most troff( 1), tbl( 1), and eqn( 1) constructions. 

Under the -v option, all words not literally in the spelling list are printed, and plausible derivations from the 
words in the spelling list are indicated. 

Under the -b option, British spelling is checked. Besides preferring centre, colour, programme, speciality, 
travelled, etc., this option insists upon -ise in words like standardise, Fowler and the OED to the contrary 
notwithstanding. 

Under the -x option, every plausible stem is printed with = for each word. 

By default, spell (like deroff(l)) follows chains of included files (.so and nx troff(l) requests), unless the 
names of such included files begin with /usr/Iib. Under the -1 option, spell will follow the chains of all 
included files. 

Under the +localJile option, words found in localJile are removed from spell's output. LocalJile is the 
name of a user-provided file that contains a sorted list of words, one per line. With this option, the user can 
specify a set of words that are correct spellings (in addition to spell's own spelling list) for each job. 

The spelling list is based on many sources, and while more haphazard than an ordinary dictionary, is also 
more effective with respect to proper names and popular technical words. Coverage of the specialized 
vocabularies of biology, medicine, and chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indicated below with their default settings 
(see FILES). Copies of all output are accumulated in the history file. The stop list filters out misspellings 
(e.g., thier=thy-y+ier) that would otherwise pass. 

Three routines help maintain and check the hash lists used by spell: 

hashmake Reads a list of words from the standard input and writes the corresponding nine-digit hash 
code on the standard output. 

spellin Reads n hash codes from the standard input and writes a compressed spelling list on the stan¬ 
dard output. 

hashcheck Reads a compressed spelling Jist and recreates the nine-digit hash codes for all the words in it; 
it writes these codes on the standard output. 

FILES 

D_SPELL=/usr/lib/spell/hlist[ab] hashed spelling lists, American & British 

S_SPELL=/usr/lib/spell/hstop hashed stop list 

HJSPELL=/usr/lib/spell/spellhist history file 

/usr/lib/spell/spellprog program 

SEE ALSO 

deroffd), eqn(l), sed(l), sort(l), tbl(l), tee(l), troff(l). 
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BUGS 

The spelling list’s coverage is uneven; new installations will probably wish to monitor the output for sev¬ 
eral months to gather local additions; typically, these are kept in a separate local file that is added to the 
hashed spelling list via spellin. 

The British spelling feature was done by an American. 
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NAME 

spline - interpolate smooth curve 

SYNOPSIS 

spline [ options ] 

DESCRIPTION 

Spline takes pairs of numbers from the standard input as abscissas and ordinates of a function. It produces 
a similar set, which is approximately equally spaced and includes the input set, on the standard output. The 
cubic spline output (R. W. Hamming, Numerical Methods for Scientists and Engineers, 2nd ed., pp. 349ff) 
has two continuous derivatives, and sufficiently many points to look smooth when plotted, for example by 
graph(lG). 

The following options are recognized, each as a separate argument: 

-a Supply abscissas automatically (they are missing from the input); spacing is given by the next 
argument, or is assumed to be 1 if next argument is not a number. 

-k The constant k used in the boundary value computation: 
y o = ky i, y” = ky''-i 

is set by the next argument (default k = 0). 

-n Space output points so that approximately n intervals occur between the lower and upper x limits 
(default n = 100). 

-p Make output periodic, i.e., match derivatives at ends. First and last input values should normally 
agree. 

-x Next 1 (or 2) arguments are lower (and upper) x limits. Normally, these limits are calculated from 
the data. Automatic abscissas start at lower limit (default 0). 

SEE ALSO 

graph(lG). 

DIAGNOSTICS 

When data is not strictly monotone in x, spline reproduces the input without interpolating extra points. 

BUGS 

A limit of 1,000 input points is enforced silently. 
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NAME 

split - split a file into pieces 
SYNOPSIS 

split [ -n ] [ file [ name ] ] 

DESCRIPTION 

Split reads file and writes it in n-line pieces (default 1000 lines) onto a set of output files. The name of the 
first output file is name with aa appended, and so on lexicographically, up to zz (a maximum of 676 files). 
Name cannot be longer than 12 characters. If no output name is given, x is default. 

If no input file is given, or if - is given in its stead, then the standard input file is used. 

SEE ALSO 

bfs(l), csplit(l). 
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NAME 

stat - statistical network useful with graphical commands 
SYNOPSIS 

node-name [options] [files] 

DESCRIPTION 

Stat is a collection of command level functions (nodes) that can be interconnected using sh (I) to form a sta¬ 
tistical network. The nodes reside in /usr/bin/graf (see graphics( 1G)). Data is passed through the network 
as sequences of numbers (vectors), where a number is of the form: 

[sign](digits)(.digits)[e[sign]digits] 

evaluated in the usual way. Brackets and parentheses surround fields. All fields are optional, but at least 
one of the fields surrounded by parentheses must be present. Any character input to a node that is not part 
of a number is taken as a delimiter. 

Stat nodes are divided into four classes. 

Transformers , which map input vector elements into output vector elements; 

Summarizes, which calculate statistics of a vector; 

Translators , which convert among formats; and 

Generators, which are sources of definable vectors. 

Below is a list of synopses for stat nodes. Most nodes accept options indicated by a leading minus (-). In 
general, an option is specified by a character followed by a value, such as c5. This is interpreted as c := 5 (c 
is assigned 5). The following keys are used to designate the expected type of the value: 

c characters, 

i integer, 

/ floating point or integer, 

file file name, and 

string string of characters, surrounded by quotes to include a Shell argument delimiter. 

Options without keys are flags. All nodes except generators accept files as input, hence it is not indicated 
in the synopses. 

Transformers : 

abs [ -c i ] - absolute value 

columns (similarly for -c options that follow) 

af [ -c i tv]- arithmetic function 

titled output, verbose 

ceil [ -c i ] - round up to next integer 

cusum [ -c i ] - cumulative sum 

exp [ -c i ] - exponential 

floor [ -c i ] - round down to next integer 

gamma [ -c i ] - gamma 

list [ -c i d string ] - list vector elements 

delimiter(s) 

log [ -c i b f ] - logarithm 

base 

mod [ -c i mf ] - modulus 

modulus 
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pair 

[ -c i F file xi ] - pair elements 

File containing base vector, x group size 

power 

[ -c i p f ] - raise to a power 
power 

root 

[ —c i rf ] - take a root 
root 

round 

[-c i pz si ] - round to nearest integer, .5 rounds to 1 
places after decimal point, significant digits 

siline 

[-cz i/nzs/ ] - generate a line given slope and intercept 
intercept, number of positive integers, slope 

sin 

[ —c i ] - sine 

subset 

[-a/b/cz F file i; 1/nl np p/s/tz ] - generate a subset 

above, below. File with master vector, interval, leave, master contains element numbers 
to leave, master contains element numbers to pick, pick, start, terminate 

Summarizers : 

bucket 

[ -a; c i Vfile h/iz If n i ] - break into buckets 

average size. File containing bucket boundaries, high, interval, low, number 

cor 

[ -F file ] - correlation coefficient 

File containing base vector 

hilo 

[ - h 1 o ox oy ]- find high and low values 

high only, low only, option form, option form with x prepended, option form with y 
prepended 

lreg 

[ -F file i o s ] - linear regression 

File containing base vector, intercept only, option form for siline, slope only 

mean 

[-ffni p f] - (trimmed) arithmetic mean 
fraction, number, percent 

point 

[-ffni p/s ] - point from empirical cumulative density function 
fraction, number, percent, sorted input 

prod 

- internal product 

qsort 

[ -c/ ] - quick sort 

rank 

- vector rank 

total 

- sum total 

var 

- variance 

Translators'. 

bar 

[ -a b f g rz wz x/ xa y/ ya ylf yh f ] - build a bar chart 

suppress axes, bold, suppress frame, suppress grid, region, width in percent, x origin, 
suppress x-axis label, y origin, suppress y-axis label, y-axis lower bound, y-axis high 
bound 

hist 

[ -a b f g rz x/ xa y/ ya ylf yh/ ] - build a histogram 

suppress axes, bold, suppress frame, suppress grid, region, x origin, suppress x-axis 
label, y origin, suppress y-axis label, y-axis lower bound, y-axis high bound 

label 

[ -b c F 'file h p rz x xu y yr ] - label the axis of a GPS file 

bar chart input, retain case, label File, histogram input, plot input, rotation, x-axis, upper 
x-axis, y-axis, right y-axis 
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pie [-bop pm pp; r; v xi y i ] - build a pie chart 

bold, values outside pie, value as percentage(:=100), value as percentage(:=i), draw 
percent of pie, region, no values, x origin, y origin 
Unlike other nodes, input is lines of the form 
[< i e f cc >] value [label] 

ignore (don’t draw) slice, explode slice, fill slice, color slice c=( black, red, green, 
blue) 

plot [ -a b c string d f F file g m r i xf xa xi f xh/ xl/ xn/ xt y f ya yi/ yh/ yl f yn i yt ] - plot a 

graph 

suppress axes, bold, plotting characters, disconnected, suppress frame. File containing x 
vector, suppress grid, mark points, region, x origin, suppress x-axis label, x interval, x 
high bound, x low bound, number of ticks on x-axis, suppress x-axis title, y origin, 
suppress y-axis label, y interval, y high bound, y low bound, number of ticks on y-axis, 
suppress y-axis title 

title [ -b c Istring \string u string ] - title a vector or a GPS 

title bold, retain case, lower title, upper title, vector title 

Generators: 

gas [ -c i ifni sftf ] - generate additive sequence 

interval, number, start, terminate 

prime [ -c i h; 1/ m ] - generate prime numbers 
high, low, number 

rand [ -c i h f If m f n i si ] - generate random sequence 

high, low, multiplier, number, seed 

RESTRICTIONS 

Some nodes have a limit on the size of the input vector. 

SEE ALSO 

graphics(lG), gps(4). 
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NAME 

stlogin - sign on to synchronous terminal 

SYNOPSIS 

stlogin [ delay ] 

DESCRIPTION 

The stlogin command is used at the beginning of each terminal session and allows you to identify yourself 
to the system. It is invoked by the system when a synchronous terminal requests service on a connected 
synchronous line. You can direct your synchronous terminal to request service by first hitting the LOCAL 
key and then hitting the S/R key. 

Stlogin asks for your user name and your password. If you have a password, both must be entered before 
the S/R key is hit. The password field is not displayed on the screen as you enter it. 

At some installations, an option may be invoked that will require you to enter a second ‘ ‘external’ ’ pass¬ 
word. This will occur only for dial-up connections, and will be prompted by the message “External secu¬ 
rity:”. Both passwords are required for a successful login. 

If password aging has been invoked by the super-user on your behalf, your password may have expired. In 
this case, you will be shunted into passxvd( 1) to change it, after which you may attempt to login again. 

If you do not complete the login successfully within the period specified by delay (e.g., 60 seconds), you 
are likely to be silently disconnected. 

After a successful login, accounting files are updated, you will be informed of the existence (if any) of mail, 
and the profiles (i.e., /etc/profile and $HOME/.profile) (if any) are executed (see profile (A)). Stlogin ini¬ 
tializes the user and group IDs and the working directory, then executes a command interpreter (usually 
sh( 1)) according to specifications found in the /etc/passwd file. Argument 0 of the command interpreter is 
- followed by the last component of the interpreter’s path name. The environment (see environ (5)) is ini¬ 
tialized to: 

KOME=your-login-directory 
PATH=:/bin:/usr/bin 
LOGNAME =your-lo gin-name 

FILES 

/etc/utmp accounting 

/etc/wtmp accounting 

lusr/mail/your-name mailbox for user your-name 
/etc/motd message-of-the-day 

/etc/passwd password file 

/etc/profile system profile 

SHOME/.profile personal profile 

SEE ALSO 

mail(l), newgrp(l), passwd(l), sh( 1), su(l), passwd(4), profile(4), environ(5). 

DIAGNOSTICS 

Login incorrect 

if the user name or the password is incorrect. 

No shell, cannot open password file, no directory. 

consult a UNIX System programming counselor. 

Your password has expired. Choose a new one. 
if password aging is implemented. 
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NAME 

strip - strip symbol and line number information from a common object file 
SYNOPSIS 

strip [-1] [-x] [—r] [-s] [-V] file-names 
DESCRIPTION 

The strip command strips the symbol table and line number information from common object files, includ¬ 
ing archives. Once this has been done, no symbolic debugging access will be available for that file; there¬ 
fore, this command is normally run only on production modules that have been debugged and tested. 

The amount of information stripped from the symbol table can be controlled by using any of the following 
options: 

-1 Strip line number information only; do not strip any symbol table information. 

-x Do not strip static or external symbol information. 

-r Reset the relocation indexes into the symbol table. 

-s Reset the line number indexes into the symbol table (do not remove), reset the relocation 

indexes into the symbol table. 

-V Version of strip command executing. 

If there are any relocation entries in the object file and any symbol table information is to be stripped, strip 
will complain and terminate without stripping file-name unless the -r flag is used. 

If the strip command is executed on a common archive file (see ar( 4)) the archive symbol table will be 
removed. The archive symbol table must be restored by executing the ar{ 1) command with the s option 
before the archive can be link edited by the ld( 1) command. Strip( I) will instruct the user with appropriate 
warning messages when this situation arises. 

The purpose of this command is to reduce the file storage overhead taken by the object file. 

FILES 

/usr/tmp/strp?????? 

SEE ALSO 

as(l), cc(l), ld(l), ar(4), a.out(4). 

DIAGNOSTICS 

strip: name: cannot open 

if name cannot be read. 

strip: name: bad magic 

if name is not an appropriate common object file. 

strip: name: relocation entries present; cannot strip 

if name contains relocation entries and the -r flag is not used, the symbol table 
information cannot be stripped. 
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NAME 

strip - remove symbols and relocation bits 

SYNOPSIS 

strip name ... 

DESCRIPTION 

Strip removes the symbol table and relocation bits ordinarily attached to the output of the assembler and 
link editor. This is useful to save space after a program has been debugged. 

The effect of strip is the same as use of the -s option of Id(l). 

If name is an archive file, strip will remove the local symbols from any a.out format files it finds in the 
archive. Certain libraries, such as those residing in /lib, have no need for local symbols. By deleting them, 
the size of the archive is decreased and link editing performance is increased. 

FILES 

/tmp/stm* temporary file 

SEE ALSO 

ld(l), ar(4), a.out(4). 
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NAME 

ststat - report synchronous terminal facilities status 

SYNOPSIS 

ststat [ options ] 

DESCRIPTION 

Ststat prints certain information about synchronous terminal facilities. The information that is displayed is 
controlled by options: 

-a Use all print options. (This is shorthand notation for -g, -1, -p, and -t.) 

-c corefile Use the file corefile in place of /dev/kmem. 

-g Print information about gen paramaters. (Number of synchronous lines, number of printer 

ports, number of terminal ports, number of message headers, and sizes of receive and trans¬ 
mit buffer areas.) 

-1 Print information about synchronous lines. (For each synchronous line, whether or not the 

protocol script is running and whether or not it has established communications with a con¬ 
troller on the line.) 

-n namelist The argument will be taken as the name of an alternate namelist (/unix is the default). 

-p Print printer port status information. (For each assigned printer port, give the assigned path 

name and the synchronous line number and device code for the assigned printer.) If none of 
the print options -a, -g, -1, or -t are specified, -p is supplied as a default. 

-t Print terminal port status information. (For each active terminal port, give the path name of 

the terminal device and tell whether an open is waiting to be assigned to a terminal, open to 
an active terminal, or open to a device that has hung up.) 

FILES 

/dev searched to find terminal (“tty”) names 

/dev/kmem memory 
/unix system namelist 

SEE ALSO 

st(lM), st(7). 

DIAGNOSTICS 

Can’t read system namelist. 

Unable to find system name entries in the namelist file. 

No synchronous terminal lines in namelist. 

Synchronous terminals are not configured in the system in the namelist file. 

Can’t open corefile. 

Unable to open the specified corefle file. 

Can’t read corefile. 

A read failed on the corefile file. 

/dev/????? 

The name of an active terminal port could not be found in the /dev directory. 

BUGS 

Things can change while ststat is running; the picture it gives is only a close apporoximation to reality. 
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NAME 

stty - set the options for a terminal 
SYNOPSIS 

stty [ -a ] [ -g ] [ options ] 


DESCRIPTION 

Stty sets certain terminal I/O options for the device that is the current standard input; without arguments, it 
reports the settings of certain options; with the -a option, it reports all of the option settings; with the -g 
option, it reports current settings in a form that can be used as an argument to another stty command. 
Detailed information about the modes listed in the first five groups below may be found in tennioi 7) for 
asynchronous lines, or in stermiod) for synchronous lines in the UNIX System Administrator’s Manual . 
Options in the last group are implemented using options in the previous groups. Note that many combina¬ 
tions of options make no sense, but no sanity checking is performed. The options are selected from the fol¬ 
lowing: 


Control Modes 

parenb (-parenb) 
parodd (-parodd) 
cs5 cs6 cs7 cs8 

0 


enable (disable) parity generation and detection, 
select odd (even) parity, 
select character size (see termiod )). 
hang up phone line immediately. 


50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 


Set terminal baud rate to the number given, if possible. (All speeds are not sup¬ 
ported by all hardware interfaces.) 

hupcl (-hupcl) hang up (do not hang up) a DATA-PHONE nh 


hup (-hup) 
cstopb (-cstopb) 
cread (-cread) 
clocal (-clocal) 

Input Modes 

ignbrk (-ignbrk) 
brkint (-brkint) 
ignpar (-ignpar) 
parmrk (-parmrk) 
inpck (-inpck) 
istrip (-istrip) 
inlcr (-inlcr) 
igncr (-igncr) 
icrnl (-icrnl) 
iuclc (-iuclc) 
ixon (-ixon) 

ixany (-ixany) 
ixoff (-ixoff) 

Output Modes 

opost (-opost) 
olcuc (-olcuc) 
onlcr (-onlcr) 
ocrnl (-ocrnl) 
onocr (-onocr) 
onlret (-onlret) 


data set connection on last close. 

same as hupcl (-hupcl). 

use two (one) stop bits per character. 

enable (disable) the receiver. 

assume a line without (with) modem control. 

ignore (do not ignore) break on input. 

signal (do not signal) INTR on break. 

ignore (do not ignore) parity errors. 

mark (do not mark) parity errors (see termiod)). 

enable (disable) input parity checking. 

strip (do not strip) input characters to seven bits. 

map (do not map) NL to CR on input. 

ignore (do not ignore) CR on input. 

map (do not map) CR to NL on input. 

map (do not map) upper-case alphabetics to lower case on input. 

enable (disable) START/STOP output control. Output is stopped by sending an 

ASCII DCS and started by sending an ASCII DC1. 

allow any character (only DC1) to restart output. 

request that the system send (not send) START/STOP characters when the input 
queue is nearly empty/full. 

post-process output (do not post-process output; ignore all other output modes). 

map (do not map) lower-case alphabetics to upper case on output. 

map (do not map) NL to CR-NL on output. 

map (do not map) CR to NL on output. 

do not (do) output CRs at column zero. 

on the terminal NL performs (does not perform) the CR function. 
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ofill (-ofill) 
ofdel (-ofdel) 
crO crl cr2 cr3 
nlO nil 

tabO tabltab2 tab3 
bsO bsl 
1T0 ffl 
vtO vtl 
Local Modes 
isig (-isig) 

icanon (-icanon) 
xcase (-xcase) 
echo (-echo) 
echoe (-echoe) 


echok (-echok) 
lfkc (-lfkc) 
echonl (-echonl) 
nofish (-noflsh) 
stwrap (-stwrap) 

stflush (-stflush) 
stappl (-stappl) 
Control Assignments 

control-character c 


use fill characters (use timing) for delays, 
fill characters are DELs (NULs). 

select style of delay for carriage returns (see termioll)). 

select style of delay for line-feeds (see termio(l)). 

select style of delay for horizontal tabs (see termio(l ) or stermio(l)). 

select style of delay for backspaces (see termioil )). 

select style of delay for form-feeds (see termio(l)). 

select style of delay for vertical tabs (see termio(l)). 

enable (disable) the checking of characters against the special control characters 
INTR and QUIT. 

enable (disable) canonical input (ERASE and KILL processing), 
canonical (unprocessed) upper/lower-case presentation, 
echo back (do not echo back) every character typed. 

echo (do not echo) ERASE character as a backspace-space-backspace string. Note: 

this mode will erase the ERASEed character on many CRT terminals; however, it 

does not keep track of column position and, as a result, may be confusing on 

escaped characters, tabs, and backspaces. 

echo (do not echo) NL after KILL character. 

the same as echok (-echok); obsolete. 

echo (do not echo) NL. 

disable (enable) flush after INTR or QUIT. 

disable (enable) truncation of lines longer than 79 characters on a synchronous 
line. 

enable (disable) flush on a synchronous line after every write ( 2). 
use application mode (use line mode) on a synchronous line. 

set control-character to c, where control-character is erase, kill, intr, quit, eof, 
eol, ctab, min, or time (ctab is used with -stappl; see 
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NAME 

su - become super-user or another user 
SYNOPSIS 

su [ - ] [ name [ arg ... ] ] 

DESCRIPTION 

Su allows one to become another user without logging off. The default user name is root (i.e., super-user). 

To use su , the appropriate password must be supplied (unless one is already super-user). If the password is 
correct, su will execute a new shell with the user ID set to that of the specified user. To restore normal user 
ID privileges, type an EOF to the new shell. 

Any additional arguments are passed to the shell, permitting the super-user to run shell procedures with 
restricted privileges (an arg of the form -c string executes string via the shell). When additional argu¬ 
ments are passed, /bin/sh is always used. When no additional arguments are passed, su uses the shell 
specified in the password file. 

An initial - flag causes the environment to be changed to the one that would be expected if the user actually 
logged in again. This is done by invoking the shell with an argO of -su causing the .profile in the home 
directory of the new user ID to be executed. Otherwise, the environment is passed along with the possible 
exception of $PATH, which is set to /bin:/etc:/usr/bin for root. Note that the .profile can check argO for 
-sh or -su to determine how it was invoked. 

FII.ES 

/etc/passwd system’s password file 

$HOME/.profile user’s profile 

SEE ALSO 

env(l), login) 1), sh(l), environ(5). 
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NAME 

sum - print checksum and block count of a file 

SYNOPSIS 

sum [ -r ] file 

DESCRIPTION 

Sum calculates and prints a 16-bit checksum for the named file, and also prints the number of blocks in the 
file. It is typically used to look for bad spots, or to validate a file communicated over some transmission 
line. The option -r causes an alternate algorithm to be used in computing the checksum. 

SEE ALSO 

wc(l). 

DIAGNOSTICS 

“Read error” is indistinguishable from end of file on most devices; check the block count. 
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NAME 

sync - update the super block 

SYNOPSIS 

sync 

DESCRIPTION 

Sync executes the sync system primitive. If the system is to be stopped, sync must be called to insure file 
system integrity. It will flush all previously unwritten system buffers out to disk, thus assuring that all file 
modifications up to that point will be saved. See sync( 2) for details. 

SEE ALSO 

sync(2). 
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NAME 

tabs - set tabs on a terminal 
SYNOPSIS 

tabs [ tabspec ] [ +mn ] [ -Ttype ] 

DESCRIPTION 

Tabs sets the tab stops on the user’s terminal according to the tab specification tabspec, after clearing any 
previous settings. The user must of course be logged in on a terminal with remotely-settable hardware tabs. 

Users of GE TermiNet terminals should be aware that they behave in a different way than most other termi¬ 
nals for some tab settings: the first number in a list of tab settings becomes the left margin on a TermiNet 
terminal. Thus, any list of tab numbers whose first element is other than 1 causes a margin to be left on a 
TermiNet, but not on other terminals. A tab list beginning with 1 causes the same effect regardless of ter¬ 
minal type. It is possible to set a left margin on some other terminals, although in a different way (see 
below). 

Four types of tab specification are accepted for tabspec: “canned,” repetitive, arbitrary, and file. If no 
tabspec is given, the default value is -8, i.e., UNIX System “standard" tabs. The lowest column number is 
1. Note that for tabs, column 1 always refers to the leftmost column on a terminal, even one whose column 
markers begin at 0, e.g., the DASI 300, DASI 300s, and DASI450. 

-code Gives the name of one of a set of “canned” tabs. The legal codes and their meanings are as fol¬ 
lows: 

-a 1,10,16,36,72 

Assembler, IBM S/370, first format 
-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 
-c 1,8,12,16,20,55 

COBOL, normal format 
-c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). Using this code, the first typed character corre¬ 
sponds to card column 7, one space gets you to column 8, and a tab reaches column 12. Files 
using this tab setup should include a format specification as follows: 

<:t-c2 m6 s66 d:> 

-c3 1 ,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), with more tabs than -c2. This is the recom¬ 
mended format for COBOL. The appropriate format specification is: 

<:t-c3 m6 s66 d:> 

-f 1,7,11,15,19,23 

FORTRAN 

-p 1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 

PL/I 

-s 1,10,55 

SNOBOL 

-u 1,12,20,44 

UNIVAC 1100 Assembler 

In addition to these “canned” formats, three other types exist: 

-n A repetitive specification requests tabs at columns l+«, 1+2 *n, etc. Note that such a setting 

leaves a left margin of n columns on TermiNet terminals only. Of particular importance is the 
value -8: this represents the UNIX System “standard” tab setting, and is the most likely tab set¬ 
ting to be found at a terminal. It is required for use with the nroff-h option for high-speed out¬ 
put. Another special case is the value -0, implying no tabs at all. 
nl ,n2,... The arbitrary format permits the user to type any chosen set of numbers, separated by commas, in 
ascending order. Up to 40 numbers are allowed. If any number (except the first one) is preceded 
by a plus sign, it is taken as an increment to be added to the previous value. Thus, the tab lists 
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1,10,20,30 and 1,10,+10,+10 are considered identical. 

—file If the name of a file is given, tabs reads the first line of the file, searching for a format 

specification. If it finds one there, it sets the tab stops according to it, otherwise it sets them as 
-8. This type of specification may be used to make sure that a tabbed file is printed with correct 
tab settings, and would be used with the pr( 1) command: 
tabs — file; pr file 

Any of the following may be used also; if a given flag occurs more than once, the last value given takes 

effect: 

-T type Tabs usually needs to know the type of terminal in order to set tabs and always needs to know the 
type to set margins. Type is a name listed in term( 5). If no -T flag is supplied, tabs searches for 
the $TERM value in the environment (see environ (5)). If no type can be found, tabs tries a 
sequence that will work for many terminals. 

+mn The margin argument may be used for some terminals. It causes all tabs to be moved over n 
columns by making column n+1 the left margin. If +m is given without a value of n, the value 
assumed is 10. For a TermiNet, the first value in the tab list should be 1, or the margin will move 
even further to the right. The normal (leftmost) margin on most terminals is obtained by +m0. 
The margin for most terminals is reset only when the +m flag is given explicitly. 

Tab and margin setting is performed via the standard output. 


DIAGNOSTICS 

illegal tabs 
illegal increment 
unknown tab code 
can’t open 
file indirection 


when arbitrary tabs are ordered incorrectly. 

when a zero or missing increment is found in an arbitrary specification, 
when a “canned” code cannot be found, 
if — file option used, and file can’t be opened. 

if — file option used and the specification in that file points to yet another file. Indirec¬ 
tion of this form is not permitted. 


SEE ALSO 

nroffll), environ(5), term(5). 

BUGS 

There is no consistency among different terminals regarding ways of clearing tabs and setting the left mar¬ 
gin. 

It is generally impossible to usefully change the left margin without also setting tabs. 

Tabs clears only 20 tabs (on terminals requiring a long sequence), but is willing to set 40. 
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NAME 

tail - deliver the last part of a file 
SYNOPSIS 

tail [ ± [number] [lbc[f] ] ] [ file ] 

DESCRIPTION 

Tail copies the named file to the standard output beginning at a designated place. If no file is named, the 
standard input is used. 

Copying begins at distance +number from the beginning, or -number from the end of the input (if number 
is null, the value 10 is assumed). Number is counted in units of lines, blocks, or characters, according to 
the appended option I, b, or c. When no units are specified, counting is by lines. 

With the -f (“follow”) option, if the input file is not a pipe, the program will not terminate after the line of 
the input file has been copied, but will enter an endless loop, wherein it sleeps for a second and then 
attempts to read and copy further records from the input file. Thus it may be used to monitor the growth of 
a file that is being written by some other process. For example, the command: 

tail -f fred 

will print the last ten lines of the file fred, followed by any lines that are appended to fred between the time 
tail is initiated and killed. As another example, the command: 

tail -15cf fred 

will print the last 15 characters of the file fred, followed by any lines that are appended to fred between the 
time tail is initiated and killed. 

SEE ALSO 

dd(l). 

BUGS 

Tails relative to the end of the file are treasured up in a buffer, and thus are limited in length. Various kinds 
of anomalous behavior may happen with character special files. 
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NAME 

tar - tape file archiver 

SYNOPSIS 

tar [ key ] [ files ] 

DESCRIPTION 

Tar saves and restores files on magnetic tape. Its actions are controlled by the key argument. The key is a 
string of characters containing at most one function letter and possibly one or more function modifiers. 
Other arguments to the command are files (or directory names) specifying which files are to be dumped or 
restored. In all cases, appearance of a directory name refers to the files and (recursively) subdirectories of 
that directory. 

The function portion of the key is specified by one of the following letters: 

r The named files are written on the end of the tape. The c function implies this function, 

x The named files are extracted from the tape. If a named file matches a directory whose contents 

had been written onto the tape, this directory is (recursively) extracted. The owner, modification 
time, and mode are restored (if possible). If no files argument is given, the entire content of the 
tape is extracted. Note that if several files with the same name are on the tape, the last one over¬ 
writes all earlier ones. 

t The names of the specified files are listed each time that they occur on the tape. If no files argu¬ 

ment is given, all the names on the tape are listed. 

u The named files are added to the tape if they are not already there, or have been modified since 

last written on that tape. 

c Create a new tape; writing begins at the beginning of the tape, instead of after the last file. This 

command implies the r function. 

The following characters may be used in addition to the letter that selects the desired function: 

0,...,7 This modifier selects the drive on which the tape is mounted. The default is 1. 
v Normally, tar does its work silently. The v (verbose) option causes it to type the name of each 

file it treats, preceded by the function letter. With the t function, v gives more information about 
the tape entries than just the name. 

w causes tar to print the action to be taken, followed by the name of the file, and then wait for the 

user’s confirmation. If a word beginning with y is given, the action is performed. Any other 
input means “no”. 

f causes tar to use the next argument as the name of the archive instead of /dev/mt?. If the name 

of the file is -, tar writes to the standard output or reads from the standard input, whichever is 
appropriate. Thus, tar can be used as the head or tail of a pipeline. Tar can also be used to move 
hierarchies with the command: 

cd fromdir; tar cf - . I (cd todir; tar xf -) 

b causes tar to use the next argument as the blocking factor for tape records. The default is 1, the 

maximum is 20. This option should only be used with raw magnetic tape archives (see f above). 
The block size is determined automatically when reading tapes (key letters x and t). 

1 tells tar to complain if it cannot resolve all of the links to the files being dumped. If 1 is not 

specified, no error messages are printed. 

m tells tar to not restore the modification times. The modification time of the file will be the time of 

extraction. 

FILES 

/dev/mt? 

/tmp/tar* 

DIAGNOSTICS 

Complaints about bad key characters and tape read/write errors. 

Complaints if enough memory is not available to hold the link tables. 
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BUGS 

There is no way to ask for the n -th occurrence of a file. 

Tape errors are handled ungracefully. 

The u option can be slow. 

The b option should not be used with archives that are going to be updated. The current magnetic tape 
driver cannot backspace raw magnetic tape. If the archive is on a disk file, the b option should not be used 
at all, because updating an archive stored on disk can destroy it. 

The current limit on file-name length is 100 characters. 
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NAME 

tbl - format tables for nroff or troff 

SYNOPSIS 

tbl [ -TX ] [ files ] 

DESCRIPTION 

Tbl is a preprocessor that formats tables for nroff or troff( I). The input files are copied to the standard out¬ 
put, except for lines between .TS and .TE command lines, which are assumed to describe tables and are re¬ 
formatted by tbl. (The .TS and .TE command lines are not altered by tbl). 

.TS is followed by global options. The available global options are: 

center center the table (default is left-adjust); 
expand make the table as wide as the current line length; 
box enclose the table in a box; 

doublebox enclose the table in a double box; 
allbox enclose each item of the table in a box; 

tab (x) use the character x instead of a tab to separate items in a line of input data. 

The global options, if any, are terminated with a semi-colon (;). 

Next come lines describing the format of each line of the table. Each such format line describes one line of 
the actual table, except that the last format line (which must end with a period) describes all remaining 
lines of the table. Each column of each line of the table is described by a single key-letter, optionally fol¬ 
lowed by specifiers that determine the font and point size of the corresponding item, that indicate where 
vertical bars are to appear between columns, that determine column width, inter-column spacing, etc. The 
available key-letters are: 

c center item within the column; 

r right-adjust item within the column; 

1 left-adjust item within the column; 

n numerically adjust item in the column: units positions of numbers are aligned vertically; 

s span previous item on the left into this column; 

a center longest line in this column and then left-adjust all other lines in this column with 

respect to that centered line; 

~ span down previous entry in this column; 

replace this entry with a horizontal line; 

= replace this entry with a double horizontal line. 

The characters B and I stand for the bold and italic fonts, respectively; the character I indicates a vertical 
line between columns. 

The format lines are followed by lines containing the actual data for the table, followed finally by .TE. 
Within such data lines, data items are normally separated by tab characters. 

If a data line consists of only or =, a single or double line, respectively, is drawn across the table at that 
point; if a single item in a data line consists of only or =, then that item is replaced by a single or double 
line. 

Full details of all these and other features of tbl are given in the reference manual cited below. 

The -TX option forces tbl to use only full vertical line motions, making the output more suitable for devices 
that cannot generate partial vertical line motions (e.g., line printers). 

If no file names are given as arguments (or if - is specified as the last argument), tbl reads the standard 
input, so it may be used as a filter. When it is used with eqn( 1) or neqn, tbl should come first to minimize 
the volume of data passed through pipes. 

EXAMPLE 

If we let —> represent a tab (which should be typed as a genuine tab), then the input: 
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.TS 

center box ; 
cB s s 
cl I cl s 
A I c c 

linn. 

Household Population 

Town—^Households 
—>Number—>Size 

Bedmins ter—>789—>3.26 
Bernards Twp.—>3087—>3.74 
Bernardsville—>2018—>3.30 
Bound Brook—>3425—>3.04 
Bridge water—>7897—>3.81 
Far Hills—>240—>3.19 
.TE 


yields: 


Household Population 

Town 

Households 

Number 

Size 

Bedminster 

789 

3.26 

Bernards Twp. 

3087 

3.74 

Bernardsville 

2018 

3.30 

Bound Brook 

3425 

3.04 

Bridgewater 

7897 

3.81 

Far Hills 

240 

3.19 


SEE ALSO 

TBL-A Program to Format Tables in the UNIX System Document Processing Guide. 
cw(l), eqn(l), mm(l), mmt(l), nroff(l), troff(l), mm(5), mv(5). 


BUGS 

See BUGS under nroff(l). 
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NAME 

tc - phototypesetter simulator 
SYNOPSIS 

tc [ -t ] [ -sn ] [ -pi ] [ file ] 

DESCRIPTION 

Tc interprets its input (standard input default) as device codes for a Wang Laboratories, Inc. C/A/T photo¬ 
typesetter. The standard output of tc is intended for a Tektronix 4014 terminal with ASCII and APL charac¬ 
ter sets. The sixteen typesetter sizes are mapped into the 4014’s four sizes; the entire TROFF character set is 
drawn using the 4014’s character generator, with overstruck combinations where necessary. Typical usage 
is; 

troff -t files I tc 

At the end of each page, tc waits for a new-line (empty line) from the keyboard before continuing on to the 
next page. In this wait state, the command e will suppress the screen erase before the next page; sn will 
cause the next n pages to be skipped; and land will send cmd to the shell. 

The command line options are: 

-t Don't wait between pages (for directing output into a file). 

-sn Skip the first n pages. 

-p/ Set page length to /; / may include the scale factors p (points), i (inches), c (centimeters), and P 
(picas); default is picas. 

SEE ALSO 

4014(1), sh(l), tplot(lG), troff(l). 

BUGS 

Font distinctions are lost. 
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NAME 

tee - pipe fitting 
SYNOPSIS 

tee [ -i ] [ -a ] [ file ] ... 

DESCRIPTION 

Tee transcribes the standard input to the standard output and makes copies in th e files. The -i option 
ignores interrupts; the -a option causes the output to be appended to the files rather than overwriting them. 
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NAME 

test - condition evaluation command 

SYNOPSIS 

test expr 
[ expr] 

DESCRIPTION 

Test evaluates the expression expr and, if its value is true, returns a zero (true) exit status; otherwise, a 
non-zero (false) exit status is returned; test also returns a non-zero exit status if there are no arguments. 
The following primitives are used to construct expr: 

-r file true if file exists and is readable. 

-w file true if file exists and is writable. 

-xfile true if file exists and is executable. 

-f file true if file exists and is a regular file. 

-A file true if file exists and is a directory. 

-c file true if file exists and is a character special file. 

-b file true if file exists and is a block special file. 

-p file true if file exists and is a named pipe (fifo). 

-u file true if file exists and its set-user-ID bit is set. 

-g file true if file exists and its set-group-ID bit is set. 

-k file true if file exists and its sticky bit is set. 

-s file true if file exists and has a size greater than zero. 

-t [ fildes ] true if the open file whose file descriptor number is fildes (1 by default) is associated with a 
terminal device. 

-z si true if the length of string si is zero. 

-n si true if the length of the string si is non-zero. 

si = s2 true if strings si and s2 are identical. 

si != s2 true if strings si and s2 are not identical. 

si true if si is not the null string. 

nl -eq n2 true if the integers nl and n2 are algebraically equal. Any of the comparisons -ne, -gt, -ge, 
-It, and -le may be used in place of -eq. 

These primaries may be combined with the following operators: 

! unary negation operator. 

-a binary and operator. 

-o binary or operator (-a has higher precedence than -o). 

( expr ) parentheses for grouping. 

Notice that all the operators and flags are separate arguments to test. Notice also that parentheses are mean¬ 
ingful to the shell and, therefore, must be escaped. 

SEE ALSO 

find(l), sh(l). 
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WARNING 

In the second form of the command (i.e., the one that uses [], rather than the word test), the square brackets 
must be delimited by blanks. 

Some UNIX systems do not recognize the second form of the command. 
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NAME 

time - time a command 

SYNOPSIS 

time command 

DESCRIPTION 

The command is executed; after it is complete, time prints the elapsed time during the command, the time 
spent in the system, and the time spent in execution of the command. Times are reported in seconds. 

The execution time can depend on what kind of memory the program happens to land in; the user time in 
MOS is often half what it is in core. 

The times are printed on standard error. 

SEE ALSO 

timex(l), times(2). 
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NAME 

timex - time a command; report process data and system activity 

SYNOPSIS 

timex [options] command 

DESCRIPTION 

The given command is executed; the elapsed time, user time and system time spent in execution are 
reported in seconds. Optionally, process accounting data for the command and all its children can be listed 
or summarized, and total system activity during the execution interval can be reported. 

The output of timex is written on standard error. 

Options are: 

-p List process accounting records for command and all its children. Suboptions f, h, k, m, r, and t 
modify the data items reported, as defined in acctcom(l). The number of blocks read or written and 
the number of characters transferred are always reported. 

-o Report the total number of blocks read or written and total characters transferred by command and 
all its children. 

-s Report total system activity (not just that due to command ) that occurred during the execution inter¬ 
val of command. All the data items listed in sar{ 1) are reported. 

SEE ALSO 

acctcom(l), sar(l). 

WARNING 

Process records associated with command are selected from the accounting file /usr/adm/pacct by infer¬ 
ence, since process genealogy is not available. Background processes having the same user-id, terminal-id, 
and execution time window will be spuriously included. 

EXAMPLES 

A simple example: 

timex -ops sleep 60 

A terminal session of arbitrary complexity can be measured by timing a sub-shell: 
timex -opskmt sh 

session commands 

EOT 
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NAME 

toe - graphical table of contents routines 

SYNOPSIS 

dtoc [directory] 
ttoc mm-file 

vtoc [-cdhnimsvn] [TTOC file] 

DESCRIPTION 

All of the commands listed below reside in /usr/bin/graf (see graphics{\G)). 

dtoc Dtoc makes a textual table of contents, TTOC, of all subdirectories beginning at directory 

(i directory defaults to .). The list has one entry per directory. The entry fields from left to right 
are level number, directory name, and the number of ordinary readable files in the directory. 
Dtoc is useful in making a visual display of all or parts of a file system. The following will 
make a visual display of all the readable directories under /: 
dtoc/ 1 vtoc I td 

ttoc Output is the table of contents generated by the .TC macro of mini I) translated to TTOC format. 

The input is assumed to be a mm file that uses the .H family of macros for section headers. If 
no file is given, the standard input is assumed. 

vtoc Vtoc produces a GPS describing a hierarchy chart from a TTOC. The output drawing consists 

of boxes containing text connected in a tree structure. If no file is given, the standard input is 
assumed. Each TTOC entry describes one box and has the form: 
id [line-weight,line-style] "text" [mark] 

where: 

id is an alternating sequence of numbers and dots. The id specifies the position of 

the entry in the hierarchy. The id 0. is the root of the tree. 

line-weight is either: 

n, normal-weight; or 
m, medium-weight; or 
b, bold-weight. 

line-style is either: 

so, solid-line; 
do, dotted-line; 
dd, dot-dash line; 
da, dashed-line; or 
Id, long-dashed 

text is a character string surrounded by quotes. The characters between the quotes 

become the contents of the box. To include a quote within a box it must be 
escaped (V). 

mark is a character string (surrounded by quotes if it contains spaces), with included 

dots being escaped. The string is put above the top right corner of the box. To 
include either a quote or a dot within a mark it must be escaped. 

Entry example: 1.1 b,da "ABC" DEF 

Entries may span more than one line by escaping the new-line (\new-line). 

Comments are surrounded by the /*,*/ pair. They may appear anywhere in a TTOC. 

Options: 

c Use text as entered, (default is all upper case). 
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d Connect the boxes with diagonal lines. 
h« Horizontal interbox space is n % of box width, 
i Suppress the box id. 

m Suppress the box mark. 

s Do not compact boxes horizontally. 

\n Vertical interbox space is n% of box height. 

SEE ALSO 

graphics(lG), gps(4). 
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NAME 

touch - update access and modification times of a file 
SYNOPSIS 

touch [ -amc ] [ mmddhhmmfyy] ] files 
DESCRIPTION 

Touch causes the access and modification times of each argument to be updated. If no time is specified (see 
dated I)) the current time is used. The -a and -m options cause touch to update only the access or 
modification times respectively (default is -am). The -c option silently prevents touch from creating the 
file if it did not previously exist. 

The return code from touch is the number of files for which the times could not be successfully modified 
(including files that did not exist and were not created). 

SEE ALSO 

date(l), utime(2). 
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NAME 

tplot - graphics filters 
SYNOPSIS 

tplot [ -Tterminal [ -e raster ] ] 

DESCRIPTION 

These commands read plotting instructions (see plot( 4)) from the standard input and in general produce, on 
the standard output, plotting instructions suitable for a particular terminal. If no terminal is specified, the 
environment parameter $TERM (see environ ( 5)) is used. Known terminals are: 

300 DASI300. 

300S DASI 300s. 

450 DASI 450. 

4014 Tektronix 4014. 

ver Versatec D1200A. This version of plot places a scan-converted image in /usr/tmp/raster$$ and 
sends the result directly to the plotter device, rather than to the standard output. The -e option 
causes a previously scan-converted file raster to be sent to the plotter. 

FII.ES 

/usr/lib/t300 

/usr/lib/t300s 

/usr/lib/t450 

/usr/lib/t4014 

/usr/lib/vplot 

/usr/tmp/raster$$ 

SEE ALSO 

plot(3X), plot(4), term(5). 
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NAME 

tr - translate characters 
SYNOPSIS 

tr [ -cds ] [ string 1 [ string2 ] ] 

DESCRIPTION 

Tr copies the standard input to the standard output with substitution or deletion of selected characters. 
Input characters found in string1 are mapped into the corresponding characters of string2 . Any combina¬ 
tion of the options -cds may be used: 

-c Complements the set of characters in string1 with respect to the universe of characters whose 

ASCII codes are 001 through 377 octal. 

-d Deletes all input characters in string1. 

-s Squeezes all strings of repeated output characters that are in string2 to single characters. 

The following abbreviation conventions may be used to introduce ranges of characters or repeated charac¬ 
ters into the strings: 

[a-z] Stands for the string of characters whose ASCII codes run from character a to character z, inclu¬ 
sive. 

[a*n] Stands for n repetitions of a. If the first digit of n is 0, n is considered octal; otherwise, n is taken 
to be decimal. A zero or missing n is taken to be huge; this facility is useful for padding string2. 

The escape character \ may be used as in the shell to remove special meaning from any character in a string. 
In addition, \ followed by 1, 2, or 3 octal digits stands for the character whose ASCII code is given by those 
digits. 

The following example creates a list of all the words in file 1 one per line in file2, where a word is taken to 
be a maximal string of alphabetics. The strings are quoted to protect the special characters from interpreta¬ 
tion by the shell; 012 is the ASCII code for newline. 

tr -cs "[A-Z][a-z]" "[\012*]" <filel >hle2 

SEE ALSO 

ed(l), sh(l), ascii(5). 

BUGS 

Won't handle ASCII NUL in string1 or string2 ; always deletes NUL from input. 
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NAME 

troff - typeset text 
SYNOPSIS 

troff [ options ] [ files ] 


DESCRIPTION 

'Troff formats text contained in files (standard input by default) for a Wang Laboratories, Inc., C/A/T photo¬ 
typesetter. Its capabilities are described in the NROFF/TROFF User’s Manual cited below. 

An argument consisting of a minus (-) is taken to be a file name corresponding to the standard input. The 
options, which may appear in any order, but must appear before th e files, are: 

-o list Print only pages whose page numbers appear in the list of numbers and ranges, separated by 
commas. A range N—M means pages N through M; an initial -N means from the beginning to 
page A; and a final N- means from N to the end. (See BUGS below.) 

-n N Number first generated page N. 

-sN Stop every N pages. Troff will stop the phototypesetter every N pages, produce a trailer to allow 
changing cassettes, and resume when the typesetter’s start button is pressed. 

-r aN Set register a (which must have a one-character name) to N. 

-i Read standard input after files are exhausted. 

-q Invoke the simultaneous input-output mode of the .rd request. 

-z Print only messages generated by .tm (terminal message) requests. 

-m name Prepend to the input files the non-compacted (ASCII text) macro file /usr/lib/tmac/tmac.na»!e. 

-c name Prepend to the input files the compacted macro files /usr/lib/macros/cmp.[nt].[dt].H£»He and 
/usr/lib/macros/ucmp.[nt].«ame. 

-k name Compact the macros used in this invocation of troff, placing the output in files [dt \.name in the 
current directory (see the May 1979 Addendum to the NROFF/TROFF User’s Manual for details 
of compacting macro files). 

-t Direct output to the standard output instead of the phototypesetter. 

-f Refrain from feeding out paper and stopping phototypesetter at the end of the run. 

-w Wait until phototypesetter is available, if it is currently busy. 

-b Report whether the phototypesetter is busy or available. No text processing is done. 

-a Send a printable ASCII approximation of the results to the standard output. 

-p N Print all characters in point size N while retaining all prescribed spacings and motions, to reduce 

phototypesetter elapsed time. 

-g Prepare output for the Murray Hill Computation Center phototypesetter and direct it to the stan¬ 

dard output (this option is not usable on most systems). This option is not compatible with the -s 
option; furthermore, when this option is invoked, all fp (font position) requests (if any) in the 
troff input must come before the first break, and no .tl requests may come before the first break. 
-T name Use font-width tables for device name (the font tables are found in /usr/Iib/font/name/*). Cur¬ 
rently, no names are supported. 


FILES 

/usr/lib/suftab 

/tmp/ta$# 

/usr/lib/tmac/tmac.* 
/usr/lib/macros/* 
/usr/lib/font/* 


suffix hyphenation tables 
temporary file 

standard macro files and pointers 
standard macro files 
font width tables for troff 


SEE ALSO 

NROFF/TROFF User’s Manual and A TROFF Tutorial in the UNIX System Document Processing Guide. 
cw(l), eqn(l), mmt(l), nrofffl), tbl(l), tc(l), mm(5), mv(5). 

BUGS 

Troff believes in Eastern Standard Time; as a result, depending on the time of the year and on your local 
time zone, the date that troff generates may be off by one day from your idea of what the date is. 

When troff is used with the -o list option inside a pipeline (e.g., with one or more of cw{ I), eqn( 1), and 
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tbl( 1)), it may cause a harmless “broken pipe” diagnostic if the last page of the document is not specified 
in list. 
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NAME 

trouble - log a trouble report 

SYNOPSIS 

trouble 

DESCRIPTION 

The trouble command is a front end for the Piscataway Change Management Tracking System (CMTS). It 
is used to log trouble reports on, or request enhancements to the UNIX System. Trouble reports will be for¬ 
warded to Piscataway via uucp( 1C), where they are transformed into Modification Requests (MRs). 

The command will prompt for the following mandatory fields: 

Name: The originator’s name (F. M. Last, F. Last, or First Last); (3 to 6 letter ID, if they 

are in the names file) 

Location: The external or internal mailing address 

Phone: The telephone number (aaaa, aaa-bbb-cccc, 8aaa-bbbb, or aaa-bbb-cccc xdddd) 

Type: sw (software), hdw (hardware), doc (documentation), enh (enhancement), unk 

(unknown) 

System: The product under discussion (usually unix) 

Machine: The CPU on which the trouble was found; na if not applicable 

Release: The product release number; na if not applicable 

Severity: 1 (out of commission, no circumvention), 2 (severity 1 if not fixed by due date 

(mo/da/yr)), 3 (needed), 4 (can be deferred) 

Date required: The due date for a severity 2 trouble report 
Trouble Area: The command or area in which the trouble was found 
Abstract: A one-line summary of the problem 

Description: The exact description of the problem; ed( 1) is the entry mechanism, so an a 

(append) must first be typed. Once the description has been entered and edited, a 
w (write) followed by a q (quit) is required. Since nroff is used to format these 
reports, all examples can be enclosed within the .ES and .EE formatter macros that 
are supplied by trouble. In addition, any backslashes should be entered using the 
\e construct. 

A response of ? will cause the expected format of the response to be displayed. 

Unless the description states otherwise, the trouble report may be selected to appear in the MINI-SYSTEM 
NEWSLETTER. 

FILES 

/usr/lib/trouble/tr.a archived trouble reports 

/usr/lib/trouble/instruct instructions 
/usr/lib/trouble/trsh trouble report shell 

/usr/lib/trouble/trxmit re-transmission shell 
/usr/lib/trouble/names letter ID data base 

SEE ALSO 

uucp(lC). 
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NAME 

true, false - provide truth values 

SYNOPSIS 

true 

false 

DESCRIPTION 

True does nothing, successfully. False does nothing, unsuccessfully. They are typically used in input to 
sh( 1) such as: 

while true 
do 

command 

done 

SEE ALSO 

sh(l). 

DIAGNOSTICS 

True has exit status zero, false nonzero. 
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NAME 

tsort - topological sort 

SYNOPSIS 

tsort [ file ] 

DESCRIPTION 

Tsort produces on the standard output a totally ordered list of items consistent with a partial ordering of 
items mentioned in the input file. If no file is specified, the standard input is understood. 

The input consists of pairs of items (nonempty strings) separated by blanks. Pairs of different items indi¬ 
cate ordering. Pairs of identical items indicate presence, but not ordering. 

SEE ALSO 

lorder(l). 

DIAGNOSTICS 

Odd data: there is an odd number of fields in the input file. 

BUGS 

Uses a quadratic algorithm; not worth fixing for the typical use of ordering a library archive file. 
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NAME 

tty - get the terminal’s name 

SYNOPSIS 

tty [ -1 ] [ -s ] 

DESCRIPTION 

Tty prints the path name of the user’s terminal. The -1 option prints the synchronous line number to which 
the user’s terminal is connected, if it is on an active synchronous line. The -s option inhibits printing of the 
terminal’s path name, allowing one to test just the exit code. 

EXIT CODES 

2 if invalid options were specified, 

0 if standard input is a terminal, 

1 otherwise. 

DIAGNOSTICS 

“not on an active synchronous line” if the standard input is not a synchronous terminal and -1 is specified, 
“not a tty” if the standard input is not a terminal and -s is not specified. 
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NAME 

umask - set file-creation mode mask 

SYNOPSIS 

umask [ ooo ] 

DESCRIPTION 

The user file-creation mode mask is set to ooo. The three octal digits refer to read/write/execute permis¬ 
sions for owner, group, and others, respectively (see chmod{ 2) and mnaskd)). The value of each specified 
digit is subtracted from the corresponding “digit” specified by the system for the creation of a file (see 
creat( 2)). For example, umask 022 removes group and others write permission (files normally created 
with mode 777 become mode 755; files created with mode 666 become mode 644). 

If ooo is omitted, the current value of the mask is printed. 

Umask is recognized and executed by the shell. 

SEE ALSO 

chmod(l), sh( 1), chmod(2), creat(2), umask(2). 
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NAME 

uname - print name of current UNIX System 

SYNOPSIS 

uname [ -snrvma ] 

DESCRIPTION 

Uname prints the current system name of the UNIX System on the standard output file. It is mainly useful 
to determine what system one is using. The options cause selected information returned by uname(2) to be 
printed: 

-s print the system name (default). 

-n print the nodename (the nodename may be a name that the system is known by to a communica¬ 
tions network). 

-r print the operating system release. 

-v print the operating system version. 

-m print the machine hardware name. 

-a print all the above information. 

Arguments not recognized default the command to the -s option. 

SEE ALSO 

uname(2). 
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NAME 

unget - undo a previous get of an SCCS file 
SYNOPSIS 

unget [-rSID] [-s] [—n] files 
DESCRIPTION 

Unget undoes the effect of a get -e done prior to creating the intended new delta. If a directory is named, 
unget behaves as though each file in the directory were specified as a named file, except that non-SCCS files 
and unreadable files are silently ignored. If a name of - is given, the standard input is read with each line 
being taken as the name of an SCCS file to be processed. 

Keyletter arguments apply independently to each named file. 

-r SID Uniquely identifies which delta is no longer intended. (This would have been 

specified by get as the “new delta”). The use of this keyletter is necessary only if 
two or more outstanding gets for editing on the same SCCS file were done by the same 
person (login name). A diagnostic results if the specified SID is ambiguous, or if it is 
necessary and omitted on the command line. 

-s Suppresses the printout, on the standard output, of the intended delta’s SID. 

-n Causes the retention of the gotten file which would normally be removed from the cur¬ 

rent directory. 

SEE ALSO 

delta(l), get(l), sact(l). 

DIAGNOSTICS 

Use help( 1) for explanations. 
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NAME 

uniq - report repeated lines in a file 
SYNOPSIS 

uniq [ -udc [ +n ] [ -n ] ] [ input [ output ] ] 

DESCRIPTION 

Uniq reads the input file comparing adjacent lines. In the normal case, the second and succeeding copies of 
repeated lines are removed; the remainder is written on the output file. Input and output should always be 
different. Note that repeated lines must be adjacent in order to be found; see sort{ 1). If the -u flag is used, 
just the lines that are not repeated in the original file are output. The -d option specifies that one copy of 
just the repeated lines is to be written. The normal mode output is the union of the -u and -d mode out¬ 
puts. 

The -c option supersedes -u and -d and generates an output report in default style but with each line pre¬ 
ceded by a count of the number of times it occurred. 

The n arguments specify skipping an initial portion of each line in the comparison: 

—n The first n fields together with any blanks before each are ignored. A field is defined as a string 

of non-space, non-tab characters separated by tabs and spaces from its neighbors. 

+n The first n characters are ignored. Fields are skipped before characters. 

SEE ALSO 

comm(l), sort(l). 
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NAME 

units - conversion program 

SYNOPSIS 

units 

DESCRIPTION 

Units converts quantities expressed in various standard scales to their equivalents in other scales. It works 
interactively in this fashion: 

You have: inch 
You want: cm 

* 2.540000e+00 
/ 3.937008e-01 

A quantity is specified as a multiplicative combination of units optionally preceded by a numeric multiplier. 
Powers are indicated by suffixed positive integers, division by the usual sign: 

You have: 15 lbs force/in2 

You want: atm 

* 1.020689e+00 
/ 9.797299e-01 

Units only does multiplicative scale changes; thus it can convert Kelvin to Rankine, but not Celsius to 
Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recognized, together with a generous 
leavening of exotica and a few constants of nature including: 


Pi 

ratio of circumference to diameter. 

c 

speed of light. 

e 

charge on an electron. 

g 

acceleration of gravity. 

force 

same as g. 

mole 

Avogadro’s number. 

water 

pressure head per unit height of water. 

au 

astronomical unit. 


Pound is not recognized as a unit of mass; lb is. Compound names are run together, (e.g. lightyear). Brit¬ 
ish units that differ from their U.S. counterparts are prefixed thus: brgallon. For a complete list of units, 
type: 

cat /usr/lib/unittab 

FILES 

/usr/lib/unittab 
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NAME 

uucp, uulog, uuname - unix to unix copy 
SYNOPSIS 

uucp [ options ] source-files destination-file 
uulog [ options ] 

uuname [ -1 ] 

DESCRIPTION 

Uucp. 

Uucp copies files named by the source-file arguments to the destination-file argument. A file name may be 
a path name on your machine, or may have the form: 

system-name !path-name 

where system-name is taken from a list of system names which uucp knows about. The system-name may 
also be a list of names such as 

system-name! system-name!...! system-name !path-name 

in which case an attempt is made to send the file via the specified route, and only to a destination in PUB- 
DIR (see below). Care should be taken to insure that intermediate nodes in the route are willing to foward 
information. 

The shell metacharacters ?, * and [...] appearing in path-name will be expanded on the appropriate sys¬ 
tem. 

Path names may be one of: 

(1) a full path name; 

(2) a path name preceded by ~user where user is a login name on the specified system and is 
replaced by that user’s login directory; 

(3) a path name preceded by ~luser where user is a login name on the specified system and is 
replaced by that user’s directory under PUBDIR; 

(4) anything else is prefixed by the current directory. 

If the result is an erroneous path name for the remote system the copy will fail. If the destination-file is a 
directory, the last part of the source-file name is used. 

Uucp preserves execute permissions across the transmission and gives 0666 read and write permissions 
(see chmod( 2)). 

The following options are interpreted by uucp : 

-d Make all necessary directories for the file copy (default). 

-f Do not make intermediate directories for the file copy. 

-c Use the source file when copying out rather than copying the file to the spool directory (default). 

-C Copy the source file to the spool directory. 

-mfile Report status of the transfer in file. If file is omitted, send mail to the requester when the copy is 
completed. 

-n user Notify user on the remote system that a file was sent. 

-esys Send the uucp command to system sys to be executed there. (Note: this will only be successful if 
the remote machine allows the uucp command to be executed by /usr/Iib/uucp/uuxqt.) 

Uucp returns on the standard output a string which is the job number of the request. This job number can 
be used by uustat to obtain status or terminate the job. 
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Uulog. 

Uulog queries a summary log of uucp and uux( 1C) transactions in the file /usr/spool/uucp/LOGFILE. 

The options cause uulog to print logging information: 

-s.vy.v Print information about work involving system sys. 

-u user Print information about work done for the specified user. 

Uuname. 

Uuname lists the uucp names of known systems. The -1 option returns the local system name. 

FTT.F.S 

/usr/spool/uucp spool directory 

/usr/spool/uucppublic public directory for receiving and sending (PUBDIR) 

/usr/lib/uucp/* other data and program files 

SEE ALSO 

mail(l), uux(lC). 

WARNING 

The domain of remotely accessible files can (and for obvious security reasons, usually should) be severely 
restricted. You will very likely not be able to fetch files by path name; ask a responsible person on the 
remote system to send them to you. For the same reasons you will probably not be able to send files to 
arbitrary path names. As distributed, the remotely accessible files are those whose names begin 
/usr/spool/uucppublic ( equivalent to ~nuucp or just ~). 

BUGS 

All files received by uucp will be owned by uucp. 

The -m option will only work sending files or receiving a single file. Receiving multiple files specified by 
special shell characters ? * [... ] will not activate the -m option. 
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NAME 

uustat - uucp status inquiry and job control 

SYNOPSIS 

uustat [ options ] 

DESCRIPTION 

Uustat will display the status of, or cancel, previously specified uucp commands, or provide general status 
on uucp connections to other systems. The following options are recognized: 

-jjobn Report the status of the uucp request jobn. If all is used for John , the status of all uucp 
requests is reported. If jobn is omitted, the status of the current user’s uucp requests is 
reported. 

-k jobn Kill the uucp request whose job number is jobn. The killed uucp request must belong to the 

person issuing the uustat command unless one is the super-user. 

-r jobn Rejuvenate jobn. That is jobn is touched so that its modification time is set to the current time. 

This prevents unclean from deleting the job until the jobs modification time reaches the limit 
imposed by uuclean. 

-chour Remove the status entries which are older than hour hours. This administrative option can 
only be initiated by the user uucp or the super-user. 

-u user Report the status of all uucp requests issued by user. 

-ssys Report the status of all uucp requests which communicate with remote system sys. 

-ohour Report the status of all uucp requests which are older than hour hours. 

-y hour Report the status of all uucp requests which are younger than hour hours. 

-m inch Report the status of accessibility of machine mch. If inch is specified as all, then the status of 

all machines known to the local uucp are provided. 

-M/hc 7; This is the same as the -m option except that two times are printed. The time that the last sta¬ 
tus was obtained and the time that the last successful transfer to that system occurred. 

-O Report the uucp status using the octal status codes listed below. If this option is not specified, 

the verbose description is printed with each uucp request. 

-q List the number of jobs and other control files queued for each machine and the time of the old¬ 

est and youngest file queued for each machine. If a lock file exists for that system, its date of 
creation is listed. 

When no options are given, uustat outputs the status of all uucp requests issued by the current user. Note 
that only one of the options -j, -m, -k, -c, -r, can be used with the rest of the other options. 

For example, the command: 

uustat -uhdc -smhtsa -y72 

will print the status of all uucp requests that were issued by user hdc to communicate with system mhtsa 
within the last 72 hours. The meanings of the job request status are: 

job-number user remote-system command-time status-time status 

where the status may be either an octal number or a verbose description. The octal code corresponds to the 
following description: 

OCTAL STATUS 

000001 the copy failed, but the reason cannot be determined 

000002 permission to access local file is denied 

000004 permission to access remote file is denied 

000010 bad uucp command is generated 

000020 remote system cannot create temporary file 

000040 cannot copy to remote directory 

000100 cannot copy to local directory 

000200 local system cannot create temporary file 
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000400 cannot execute uucp 

001000 copy (partially) succeeded 

002000 copy finished, job deleted 

004000 job is queued 

010000 job killed (incomplete) 

020000 job killed (complete) 

The meanings of the machine accessibility status are: 

system-name time status 

where time is the latest status time and status is a self-explanatory description of the machine status. 

FILES 

/usr/spool/uucp spool directory 

/usr/lib/uucp/L stat system status file 

/usr/lib/uucp/R stat request status file 

SEE ALSO 

uucp(lC). 
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NAME 

uuto, uupick - public UNIX System-to-UNIX System file copy 
SYNOPSIS 

uuto [ options ] source-files destination 
uupick [ -s system ] 

DESCRIPTION 

Uuto sends source-files to destination. Uuto uses the uucp{ 1C) facility to send files, while it allows the 
local system to control the file access. A source-file name is a path name on your machine. Destination has 
the form: 

system! user 

where system is taken from a list of system names that uucp knows about (see uuname). Logname is the 
login name of someone on the specified system. 

Two options are available: 

-p Copy the source file into the spool directory before transmission. 

-m Send mail to the sender when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUB DIR on system, where PUBDIR is a public 
directory defined in the uucp source. Specifically the files are sent to 

PUBDIR/receive/Mser/mysysfe/ra/files. 

The destined recipient is notified by mail( 1) of the arrival of files. 

Uupick accepts or rejects the files transmitted to the user. Specifically, uupick searches PUBDIR for files 
destined for the user. For each entry (file or directory) found, the following message is printed on the stan¬ 
dard output: 

from system: [file file-name] [dir dirname] ? 

Uupick then reads a line from the standard input to determine the disposition of the file: 

<new-line> Go on to next entry, 

d Delete the entry. 

m [ dir ] Move the entry to named directory dir (current directory is default), 

a [ dir ] Same as m except moving all the files sent from system . 

p Print the content of the file, 

q Stop. 

EOT (control-d) Same as q. 

! command Escape to the shell to do command. 

* Print a command summary. 

Uupick invoked with the -s system option will only search the PUBDIR for files sent from system. 

FILES 

PUBDIR /usr/spool/uucppublic public directory 

SEE ALSO 

mail(l), uuclean(lM), uucp(lC), uustat(lC), uux(lC). 
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NAME 

uux - unix to unix command execution 
SYNOPSIS 

uux [ options ] command-string 

DESCRIPTION 

Uux will gather zero or more files from various systems, execute a command on a specified system and then 
send standard output to a file on a specified system. Note that, for security reasons, many installations will 
limit the list of commands executable on behalf of an incoming request from uux. Many sites will permit 
little more than the receipt of mail (see mail{ 1)) via uux. 

The command-string is made up of one or more arguments that look like a Shell command line, except that 
the command and file names may be prefixed by system-namel. A null system-name is interpreted as the 
local system. 

File names may be one of 

(1) a full path name; 

(2) a path name preceded by ~xxx where xxx is a login name on the specified system and is 
replaced by that user’s login directory; 

(3) anything else is prefixed by the current directory. 

As an example, the command 

uux " !diff usg!/usr/dan/fl pwba!/a4/dan/fl > Ifl.diff" 

will get the fl files from the “usg” and “pwba” machines, execute a diff command and put the results in 
fl.diff in the local directory. 

Any special shell characters such as <>; I should be quoted either by quoting the entire command-string, or 
quoting the special characters as individual arguments. 

Uux will attempt to get all files to the execution system. For files which are output files, the file name must 
be escaped using parentheses. For example, the command 

uux a!uucp b!/usr/file \(c!/usr/file\) 

will send a uucp command to system “a” to get /usr/file from system “b” and send it to system “c”. 

Uux will notify you if the requested command on the remote system was disallowed. The response comes 
by remote mail from the remote machine. 

The following options are interpreted by uux: 

- The standard input to uux is made the standard input to the command-string. 

-n Send no notification to user. 

-m/z/e Report status of the transfer in file. If file is omitted, send mail to the requester when the copy is 
completed. 

Uux returns an ASCII string on the standard output which is the job number. This job number can be used 
by uustat to obtain the status or terminate a job. 

FILES 

/usr/lib/uucp/spool spool directory 

/usr/lib/uucp/* other data and programs 

SEE ALSO 

uuclean(lM), uucp(lC). 

BUGS 

Only the first command of a shell pipeline may have a system-namel. All other commands are executed on 
the system of the first command. 
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The use of the shell metacharacter * will probably not do what you want it to do. The shell tokens « and 
» are not implemented. 
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NAME 

val - validate SCCS file 

SYNOPSIS 

val - 

val [-s] [-rSID] [-mname] [-ytype] files 

DESCRIPTION 

Val determines if the specified file is an SCCS file meeting the characteristics specified by the optional argu¬ 
ment list. Arguments to val may appear in any order. The arguments consist of keyletter arguments, which 
begin with a and named files. 

Val has a special argument, -, which causes reading of the standard input until an end-of-file condition is 
detected. Each line read is independently processed as if it were a command line argument list. 

Val generates diagnostic messages on the standard output for each command line and file processed and 
also returns a single 8-bit code upon exit as described below. 

The keyletter arguments are defined as follows. The effects of any keyletter argument apply independently 
to each named file on the command line. 

-s The presence of this argument silences the diagnostic message normally generated 

on the standard output for any error that is detected while processing each named 
file on a given command line. 

-rSID The argument value SID (.S'CCS /Dentification String) is an SCCS delta number. A 

check is made to determine if the SID is ambiguous (e. g., rl is ambiguous because 
it physically does not exist but implies 1.1, 1.2, etc. which may exist) or invalid (e. 
g„ rl.O or r 1.1.0 are invalid because neither case can exist as a valid delta num¬ 
ber). If the SID is valid and not ambiguous, a check is made to determine if it actu¬ 
ally exists. 

-m name The argument value name is compared with the SCCS %M% keyword in file. 

-ytype The argument value type is compared with the SCCS %Y% keyword in file. 

The 8-bit code returned by val is a disjunction of the possible errors, i. e., can be interpreted as a bit string 
where (moving from left to right) set bits are interpreted as follows: 

bit 0 = missing file argument; 

bit 1 = unknown or duplicate keyletter argument; 

bit 2 = corrupted SCCS file; 

bit 3 = can’t open file or file not SCCS; 

bit 4 = SID is invalid or ambiguous; 

bit 5 = SID does not exist; 

bit 6 = %Y%, -y mismatch; 

bit 7 = %M%, -m mismatch; 

Note that val can process two or more files on a given command line and in turn can process multiple com¬ 
mand lines (when reading the standard input). In these cases an aggregate code is returned - a logical OR 
of the codes generated for each command line and file processed. 

SEE ALSO 

admin(l), delta(l), get(l), prs(l). 

DIAGNOSTICS 

Use help{ 1) for explanations. 

BUGS 

Val can process up to 50 files on a single command line. Any number above 50 will produce a core dump. 


Page 1 



VC(1) 


VC(1) 


NAME 

vc - version control 
SYNOPSIS 

vc [-a] [-t] [-cchar] [-s] [keyword=value ... keyword=value] 

DESCRIPTION 

The vc command copies lines from the standard input to the standard output under control of its arguments 
and control statements encountered in the standard input. In the process of performing the copy operation, 
user declared keywords may be replaced by their string value when they appear in plain text and/or control 
statements. 

The copying of lines from the standard input to the standard output is conditional, based on tests (in control 
statements) of keyword values specified in control statements or as vc command arguments. 

A control statement is a single line beginning with a control character, except as modified by the -t keylet- 
ter (see below). The default control character is colon (:), except as modified by the -c keyletter (see 
below). Input lines beginning with a backslash (\) followed by a control character are not control lines and 
are copied to the standard output with the backslash removed. Lines beginning with a backslash followed 
by a non-control character are copied in their entirety. 

A keyword is composed of 9 or less alphanumerics; the first must be alphabetic. A value is any ASCII 
string that can be created with ed( 1); a numeric value is an unsigned string of digits. Keyword values may 
not contain blanks or tabs. 

Replacement of keywords by values is done whenever a keyword surrounded by control characters is 
encountered on a version control statement. The -a keyletter (see below) forces replacement of keywords 
in all lines of text. An uninterpreted control character may be included in a value by preceding it with Y If 
a literal \ is desired, then it too must be preceded by Y 

Keyletter arguments 

-a Forces replacement of keywords surrounded by control characters with their 

assigned value in all text lines and not just in vc statements. 

-t All characters from the beginning of a line up to and including the first tab charac¬ 

ter are ignored for the purpose of detecting a control statement. If one is found, all 
characters up to and including the tab are discarded. 

-cchar Specifies a control character to be used in place of :. 

-s Silences warning messages (not error) that are normally printed on the diagnostic 

output. 

Version Control Statements 

:dcl keyword[,.... keyword] 

Used to declare keywords. All keywords must be declared. 

:asg keyword=value 

Used to assign values to keywords. An asg statement overrides the assignment for the corresponding 
keyword on the vc command line and all previous asg’s for that keyword. Keywords declared, but 
not assigned values have null values. 

:if condition 

:end 

Used to skip lines of the standard input. If the condition is true all lines between the if statement and 
the matching end statement are copied to the standard output. If the condition is false, all intervening 
lines are discarded, including control statements. Note that intervening if statements and matching 
end statements are recognized solely for the purpose of maintaining the proper if-end matching. 
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The syntax of a condition is: 

<cond> ::= [ "not" ] <or> 

<or> ::= <and> | <and> <or> 

<and> ::= <exp> | <exp> "&" <and> 

<exp> ::= "(" <or> ")" | <value> <op> <value> 

<op> I "<" I ">" 

<value> ::= <arbitrary ASCII string> | <numeric string> 

The available operators and their meanings are: 

equal 
not equal 
and 
or 

greater than 
less than 

used for logical groupings 
may only occur immediately after the if, and 
when present, inverts the value of the 
entire condition 

The > and < operate only on unsigned integer values (e. g.: 012 > 12 is false). All other operators 
take strings as arguments (e. g.: 012 != 12 is true). The precedence of the operators (from highest to 
lowest) is: 

= != > < all of equal precedence 
& 

I 

Parentheses may be used to alter the order of precedence. 

Values must be separated from operators or parentheses by at least one blank or tab. 

::text 

Used for keyword replacement on lines that are copied to the standard output. The two leading con¬ 
trol characters are removed, and keywords surrounded by control characters in text are replaced by 
their value before the line is copied to the output file. This action is independent of the -a keyletter. 

:on 

:off 

Turn on or off keyword replacement on all lines. 

:ctl char 

Change the control character to char. 

:msg message 

Prints the given message on the diagnostic output. 

:err message 

Prints the given message followed by: 

ERROR: err statement on line ... (915) 
on the diagnostic output. Vc halts execution, and returns an exit code of 1. 

DIAGNOSTICS 

Use help( 1) for explanations. 

EXIT CODES 

0 - normal 
1 - any error 


! = 
& 

I 

> 

< 

() 

not 
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NAME 

vi - screen oriented (visual) display editor based on ex 
SYNOPSIS 

vi [ -t tag ] [ -r ] [ +command ] [ -1 ] [ -wh ] name ... 

DESCRIPTION 

Vi (visual) is a display oriented text editor based on ex( 1). Ex and vi run the same code; it is possible to get 
to the command mode of ex from within vi and vice-versa. 

The Vi Quick Reference card and the Introduction to Display Editing with Vi provide full details on using 
vi. 


FILES 

See ex(l). 

SEE ALSO 

ex (1), edit (1), “Vi Quick Reference” card, “An Introduction to Display Editing with Vi”. 

AUTHOR 

William Joy 

Mark Horton added macros to visual mode and is maintaining version 3 

BUGS 

Software tabs using 'T work only immediately after the autoindent. 

Left and right shifts on intelligent terminals don't make use of insert and delete character operations in the 
terminal. 

The wrapmargin option can be fooled since it looks at output columns when blanks are typed. If a long 
word passes through the margin and onto the next line without a break, then the line won't be broken. 

Insert/delete within a line can be slow if tabs are present on intelligent terminals, since the terminals need 
help in doing this correctly. 

Saving text on deletes in the named buffers is somewhat inefficient. 

The source command does not work when executed as rsource; there is no way to use the :append, 
:change, and rinsert commands, since it is not possible to give more than one line of input to a : escape. 
To use these on a : global you must Q to ex command mode, execute them, and then reenter the screen edi¬ 
tor with vi or open. 

SUPPORT 

COMPONENT NAME: vi 
AUTHORIZER: HOLMDEL 
STATUS: LOCAL 
SUPPLIER: Dept 45223 

USER INTERFACE: Program Counseling Sendee 
SUPPORT LEVEL: Provisional 

COMMENTS: Version 2.1* is for the PDF 11/70 and version 
3.6 is for the VAX. 
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NAME 

vpr - Versatec printer spooler 
SYNOPSIS 

vpr [ options ] [ files ] 

DESCRIPTION 

Vpr causes the named files to be queued for printing on a Versatec printer. If no names appear, the stan¬ 
dard input is assumed; thus vpr may be used as a filter. 

The following options may be given (each as a separate argument and in any order) before any file name 
arguments: 

-c Make a copy of the file to be sent before returning to the user. 

-r Remove the file after sending it. 

-m When printing is complete, report that fact by mail( 1). 

-n Do not report the completion of printing by mail{ 1). This is the default option. 

-f file \Jse file as a dummy file name to report back in the mail. (This is useful for distinguishing multi¬ 

ple runs, especially when vpr is being used as a filter). 

-p [ -e raster ] 

Use the plot filter vplot to output files produced by graph{ 1G). The -e option will cause a previ¬ 
ously scan converted file raster to be sent to the Versatec. 

EXAMPLES 

Two common uses are; 

pr [ options ] file I vpr 

and 

graph [ options ] file I vpr -p 

FILES 

/etc/passwd 
/usr/spool/vpd/* 

/usr/lib/vpd 
/usr/lib/vpd.pr 
/usr/lib/vplot 

SEE ALSO 

dpr(lC), lpr(l), tplot(lG). 


user’s identification and accounting data 

spool area 

line printer daemon 

print filter 
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NAME 

wait - await completion of process 

SYNOPSIS 

wait 

DESCRIPTION 

Wait until all processes started with & have completed, and report on abnormal terminations. 

Because the wait{ 2) system call must be executed in the parent process, the shell itself executes wait, with¬ 
out creating a new process. 

SEE ALSO 

sh(l). 

BUGS 

Not all the processes of a 3- or more-stage pipeline are children of the shell, and thus can’t be waited for. 
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NAME 

wc - word count 

SYNOPSIS 

wc [ -lwc ] [ names ] 

DESCRIPTION 

Wc counts lines, words and characters in the named files, or in the standard input if no names appear. It 
also keeps a total count for all named files. A word is a maximal string of characters delimited by spaces, 
tabs, or new-lines. 

The options 1, w, and c may be used in any combination to specify that a subset of lines, words, and charac¬ 
ters are to be reported. The default is -lwc. 

When names are specified on the command line, they will be printed along with the counts. 
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NAME 

what - identify SCCS files 

SYNOPSIS 

what files 

DESCRIPTION 

What searches the given files for all occurrences of the pattern that get( 1) substitutes for %Z% (this is @(#) 
at this printing) and prints out what follows until the first ", >, new-line, \, or null character. For example, 
if the C program in file f.c contains 

char ident[] = " @(^identification information 

and f.c is compiled to yield f.o and a.out, then the command 

what f.c f.o a.out 


will print 


f.c: 

identification information 

f.o: 

identification information 

a.out: 

identification information 


What is intended to be used in conjunction with the command get( 1), which automatically inserts identify¬ 
ing information, but it can also be used where the information is inserted manually. 

SEE ALSO 

get(l), help(l). 

DIAGNOSTICS 

Use help( 1) for explanations. 

BUGS 

It’s possible that an unintended occurrence of the pattern @(#) could be found just by chance, but this 
causes no harm in nearly all cases. 
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NAME 

who - who is on the system 

SYNOPSIS 

who [ -uTlpdbrtas ] [ file ] 
who am i 
DESCRIPTION 

Who can list the user’s name, terminal line, login time, elapsed time since activity occurred on the line, and 
the process-ID of the command interpreter (shell) for each current UNIX System user. It examines the 
/etc/utmp file to obtain its information. If file is given, that file is examined. Usually, file will be 
/etc/wtmp, which contains a history of all the logins since the file was last created. 

Who with the am i option identifies the invoking user. 

Except for the default -s option, the general format for output entries is: 

name [state] line time activity pid [comment] [exit] 

With options, who can list logins, logoffs, reboots, and changes to the system clock, as well as other pro¬ 
cesses spawned by the init process. These options are: 

-u This option lists information about those users who are currently logged in. The name is the user’s 
login name. The line is the name of the line as found in the directory /dev. The time is the time that 
the user logged in. The activity is the number of hours and minutes since activity last occurred on 
that particular line. A dot (.) indicates that the terminal has seen activity in the last minute and is 
therefore “current”. If more than twenty-four hours have elapsed or the line has not been used 
since boot time, the entry is marked old. This field is useful when trying to determine whether a 
person is working at the terminal or not. The pid is the process-ID of the user’s shell. The comment 
is the comment field associated with this line as found in /etc/inittab (see inittab(4)). This can con¬ 
tain information about where the terminal is located, the telephone number of the dataset, type of 
terminal if hard-wired, etc. 

-T This option causes the state of the terminal line to be printed. The state describes whether someone 
else can write to that terminal. A + appears if the terminal is writable by anyone; a - appears if it is 
not. Root can write to all lines having a + or a - in the state field. If a bad line is encountered, a ? 
is printed. 

-1 This option lists only those lines on which the system is waiting for someone to login. The name 
field is LOGIN in such cases. Other fields are the same as for user entries except that the state field 
doesn’t exist. 

-p This option lists any other process which is currently active and has been previously spawned by 
init. The name field is the name of the program executed by init as found in /etc/inittab. The state, 
line, and activity fields have no meaning. The comment field shows the id field of the line from 
/etc/inittab that spawned this process. See inittab(4). 

-d This option displays all processes that have expired and not been respawned by init. The exit field 
appears for dead processes and contains the termination and exit values (as returned by wait(2)), of 
the dead process. This can be useful in determining why a process terminated. 

-b This option indicates the time and date of the last reboot. 

-r This option indicates the current run-level of the init process. Following the run-level and date 
information are three fields which indicate the current state, the number of times that state was pre¬ 
viously entered, and the previous state. 

-t This option indicates the last change to the system clock (via the date( 1) command) by root. See 
sn(l). 

-a This option processes /etc/utmp or the named file with all options turned on. 
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-s This option is the default and lists only the name, line and time fields. 

FILES 

/etc/utmp 

/etc/wtmp 

/etc/inittab 

SEE ALSO 

init(lM) in the UNIX System Administrator’s Manual. 
date(l), login(l), mesg(l), su(l), wait(2), inittab(4), utmp(4). 
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NAME 

write - write to another user 

SYNOPSIS 

write user [ line ] 

DESCRIPTION 

Write copies lines from your terminal to that of another user. When first called, it sends the message: 
Message from youmame (tty??) [ date ]... 

to the person you want to talk to. When it has successfully completed the connection it also sends two bells 
to your own terminal to indicate that what you are typing is being sent. 

The recipient of the message should write back at this point. Communication continues until an end of file 
is read from the terminal or an interrupt is sent. At that point write writes EOT on the other terminal and 
exits. 

If you want to write to a user who is logged in more than once, the line argument may be used to indicate 
which line or terminal to send to (e.g., ttyOO); otherwise, the first instance of the user found in /etc/utmp is 
assumed and the following message posted: 

user is logged on more than one place. 

You are connected to "terminal". 

Other locations are: 
terminal 

Permission to write may be denied or granted by use of the mesg(l) command. Writing to others is nor¬ 
mally allowed by default. Certain commands, in particular nroff(l) and pr( 1) disallow messages in order to 
prevent interference with their output. However, if the user has super-user permissions, messages can be 
forced onto a write inhibited terminal. 

If the character ! is found at the beginning of a line, write calls the shell to execute the rest of the line as a 
command. 

The following protocol is suggested for using write: when you first write to another user, wait for them to 
write back before starting to send. Each person should end a message with a distinctive signal (i.e., (o) for 
“over”) so that the other person knows when to reply. The signal (oo) (for “over and out”) is suggested 
when conversation is to be terminated. 

FILES 

/etc/utmp to find user 

/bin/sh to execute ! 

SEE ALSO 

mail(l), mesg(l), nroff(l), pr(l), sh(l), who(l). 

DIAGNOSTICS 

“user not logged in ’ ’ if the person you are trying to write to is not logged in. 
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NAME 

xargs - construct argument list(s) and execute command 

SYNOPSIS 

xargs [flags] [ command [initial-arguments] ] 

DESCRIPTION 

Xargs combines the fixed initial-arguments with arguments read from standard input to execute the 
specified command one or more times. The number of arguments read for each command invocation and 
the manner in which they are combined are determined by the flags specified. 

Command, which may be a shell file, is searched for, using one’s $PATH. If command is omitted, 

/bin/echo is used. 

Arguments read in from standard input are defined to be contiguous strings of characters delimited by one 
or more blanks, tabs, or new-lines; empty lines are always discarded. Blanks and tabs may be embedded as 
part of an argument if escaped or quoted: Characters enclosed in quotes (single or double) are taken liter¬ 
ally, and the delimiting quotes are removed. Outside of quoted strings a backslash (Y) will escape the next 
character. 


Each argument list is constructed starting with the initial-arguments, followed by some number of argu¬ 
ments read from standard input (Exception: see -i flag). Flags -i, -1, and -n determine how arguments are 
selected for each command invocation. When none of these flags are coded, the initial-arguments are fol¬ 
lowed by arguments read continuously from standard input until an internal buffer is full, and then 
command is executed with the accumulated args. This process is repeated until there are no more args. 
When there are flag conflicts (e.g., -1 vs. -n), the last flag has precedence. Flag values are: 


-1 number 


-ireplstr 


-nnumber 


-t 

-P 


Command is executed for each non-empty number lines of arguments from stan¬ 
dard input. The last invocation of command will be with fewer lines of arguments 
if fewer than number remain. A line is considered to end with the first new-line 
unless the last character of the line is a blank or a tab; a trailing blank/tab signals 
continuation through the next non-empty line. If number is omitted 1 is assumed. 
Option -x is forced. 

Insert mode: command is executed for each line from standard input, taking the 
entire line as a single arg, inserting it in initial-arguments for each occurrence of 
replstr. A maximum of 5 arguments in initial-arguments may each contain one or 
more instances of replstr. Blanks and tabs at the beginning of each line are 
thrown away. Constructed arguments may not grow larger than 255 characters, 
and option -x is also forced. {} is assumed for replstr if not specified. 

Execute command using as many standard input arguments as possible, up to 
number arguments maximum. Fewer arguments will be used if their total size is 
greater than size characters, and for the last invocation if there are fewer than 
number arguments remaining. If option -x is also coded, each number arguments 
must fit in the size limitation, else xargs terminates execution. 

Trace mode: The command and each constructed argument list are echoed to file 
descriptor 2 just prior to their execution. 

Prompt mode: The user is asked whether to execute command each invocation. 
Trace mode (-t) is turned on to print the command instance to be executed, fol¬ 
lowed by a ?... prompt. A reply of y (optionally followed by anything) will exe¬ 
cute the command; anything else, including just a carriage return, skips that partic¬ 
ular invocation of command. 


-x Causes xargs to terminate if any argument list would be greater than size charac¬ 

ters; -x is forced by the options -i and -1. When neither of the options -i, -1, or -n 
are coded, the total length of all arguments must be within the size limit. 
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-s size The maximum total size of each argument list is set to size characters; size must 

be a positive integer less than or equal to 470. If -s is not coded, 470 is taken as 
the default. Note that the character count for size includes one extra character for 
each argument and the count of characters in the command name. 

-teofstr Eofstr is taken as the logical end-of-file string. Underbar (_) is assumed for the 

logical EOF string if -e is not coded, -e with no eofstr coded turns off the logical 
EOF string capability (underbar is taken literally). Xargs reads standard input 
until either end-of-file or the logical EOF string is encountered. 

Xargs will terminate if either it receives a return code of -1 from, or if it cannot execute, command. When 
command is a shell program, it should explicitly exit (see sh( 1)) with an appropriate value to avoid acci¬ 
dentally returning with -1. 

EXAMPLES 

The following will move all files from directory $1 to directory $2, and echo each move command just 
before doing it: 

Is $1 I xargs -i -t mv $l/{ } $2/{ } 

The following will combine the output of the parenthesized commands onto one line, which is then echoed 
to the end of file log: 

(logname; date; echo $0 $*) I xargs »log 

The user is asked which files in the current directory are to be archived and archives them into arch (1.) one 
at a time, or (2.) many at a time. 

1. Is I xargs -p -1 ar r arch 

2. Is I xargs -p -1 I xargs ar r arch 

The following will execute dijfi 1) with successive pairs of arguments originally typed as shell arguments: 

echo $* I xargs -n2 diff 

DIAGNOSTICS 

Self explanatory. 
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NAME 

yacc - yet another compiler-compiler 
SYNOPSIS 

yacc [ -vdlt ] grammar 
DESCRIPTION 

Yacc converts a context-free grammar into a set of tables for a simple automaton which executes an LR(1) 
parsing algorithm. The grammar may be ambiguous; specified precedence rules are used to break ambigui¬ 
ties. 

The output file, y.tab.c, must be compiled by the C compiler to produce a program yyparse. This program 
must be loaded with the lexical analyzer program, yylex, as well as main and yyerror, an error handling 
routine. These routines must be supplied by the user; lex(l) is useful for creating lexical analyzers usable 
by yacc. 

If the -v flag is given, the file y.output is prepared, which contains a description of the parsing tables and a 
report on conflicts generated by ambiguities in the grammar. 

If the -d flag is used, the file y.tab.h is generated with the #define statements that associate the yacc- 
assigned “token codes” with the user-declared “token names”. This allows source files other than y.tab.c 
to access the token codes. 

If the -1 flag is given, the code produced in y.tab.c will not contain any #Iine constructs. This should only 
be used after the grammar and the associated actions are fully debugged. 

Runtime debugging code is always generated in y.tab.c under conditional compilation control. By default, 
this code is not included when y.tab.c is compiled. However, when yacc' s -t option is used, this debug¬ 
ging code will be compiled by default. Independent of whether the -t option was used, the runtime debug¬ 
ging code is under the control of YYDEBUG, a pre-processor symbol. If YYDEBUG has a non-zero value, 
then the debugging code is included. If its value is zero, then the code will not be included. The size and 
execution time of a program produced without the runtime debugging code will be smaller and slightly fas¬ 
ter. 


FILES 

y.output 

y.tab.c 

y.tab h defines for token names 

yacc.tmp, 

yacc.debug, yacc.acts temporary files 

/usr/lib/yaccpar parser prototype for C programs 

SEE ALSO 

lex(l). 

YACC-Yet Another Compiler Compiler in the UNIX System Support Tools Guide. 

DIAGNOSTICS 

The number of reduce-reduce and shift-reduce conflicts is reported on the standard error output; a more 
detailed report is found in the y.output file. Similarly, if some rules are not reachable from the start sym¬ 
bol, this is also reported. 

BUGS 

Because file names are fixed, at most one yacc process can be active in a given directory at a time. 
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NAME 

intro - introduction to system calls and error numbers 

SYNOPSIS 

#include <errno h> 

DESCRIPTION 

This section describes all of the system calls. Most of these calls have one or more error returns. An error 
condition is indicated by an otherwise impossible returned value. This is almost always -1; the individual 
descriptions specify the details. An error number is also made available in the external variable errno. 
Errno is not cleared on successful calls, so it should be tested only after an error has been indicated. 

All of the possible error numbers are not listed in each system call description because many errors are pos¬ 
sible for most of the calls. The following is a complete list of the error numbers and their names as defined 

in <errno h>. 

1 EPERM Not owner 

Typically this error indicates an attempt to modify a file in some way forbidden except to its owner 
or super-user. It is also returned for attempts by ordinary users to do things allowed only to the 
super-user. 

2 ENOENT No such file or directory 

This error occurs when a file name is specified and the file should exist but doesn’t, or when one of 
the directories in a path name does not exist. 

3 ESRCH No such process 

No process can be found corresponding to that specified by pid in kill or ptrace. 

4 EINTR Interrupted system call 

An asynchronous signal (such as interrupt or quit), which the user has elected to catch, occurred 
during a system call. If execution is resumed after processing the signal, it will appear as if the 
interrupted system call returned this error condition. 

5 EIO I/O error 

Some physical I/O error. This error may in some cases occur on a call following the one to which 
it actually applies. 

6 ENXIO No such device or address 

I/O on a special file refers to a subdevice which does not exist, or beyond the limits of the device. 
It may also occur when, for example, a tape drive is not on-line or no disk pack is loaded on a 
drive. 

7 E2BIG Arg list too long 

An argument list longer than 5,120 bytes is presented to a member of the exec family. 

8 ENOEXEC Exec format error 

A request is made to execute a file which, although it has the appropriate permissions, does not 
start with a valid magic number (see a.out{ 4)). 

9 EBADF Bad file number 

Either a file descriptor refers to no open file, or a read (respectively write) request is made to a file 
which is open only for writing (respectively reading). 

10 ECHILD No child processes 

A wait , was executed by a process that had no existing or unwaited-for child processes. 

11 EAGAIN No more processes 

A fork, failed because the system’s process table is full or the user is not allowed to create any 
more processes. 

12 ENOMEM Not enough space 

During an exec , brk, or sbrk, a program asks for more space than the system is able to supply. 
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This is not a temporary condition; the maximum space size is a system parameter. The error may 
also occur if the arrangement of text, data, and stack segments requires too many segmentation 
registers, or if there is not enough swap space during a fork. 

13 EACCES Permission denied 

An attempt was made to access a file in a way forbidden by the protection system. 

14 EFAULT Bad address 

The system encountered a hardware fault in attempting to use an argument of a system call. 

15 ENOTBLK Block device required 

A non-block file was mentioned where a block device was required, e.g., in mount. 

16 EBUSY Mount device busy 

An attempt to mount a device that was already mounted or an attempt was made to dismount a 
device on which there is an active file (open file, current directory, mounted-on file, active text 
segment). It will also occur if an attempt is made to enable accounting when it is already enabled. 

17 EEXIST File exists 

An existing file was mentioned in an inappropriate context, e.g., link. 

18 EXDEV Cross-device link 

A link to a file on another device was attempted. 

19 ENODEV No such device 

An attempt was made to apply an inappropriate system call to a device; e.g., read a write-only 
device. 

20 ENOTDIR Not a directory 

A non-directory was specified where a directory is required, for example in a path prefix or as an 
argument to chdir{ 2). 

21 EISDIR Is a directory 

An attempt to write on a directory. 

22 EINVAL Invalid argument 

Some invalid argument (e.g., dismounting a non-mounted device; mentioning an undefined signal 
in signal, or kill ; reading or writing a file for which Iseek has generated a negative pointer). Also 
set by the math functions described in the (3M) entries of this manual. 

23 ENFILE File table overflow 

The system’s table of open files is full, and temporarily no more opens can be accepted. 

24 EMFILE Too many open files 

No process may have more than 20 file descriptors open at a time. 

25 ENOTTY Not a typewriter 

26 ETXTBSY Text file busy 

An attempt to execute a pure-procedure program which is currently open for writing (or reading). 
Also an attempt to open for writing a pure-procedure program that is being executed. 

27 EFBIG File too large 

The size of a file exceeded the maximum file size (1,082,201,088 bytes) or ULIMIT; see ulimit{ 2). 

28 ENOSPC No space left on device 

During a write to an ordinary file, there is no free space left on the device. 

29 ESPIPE Illegal seek 

An Iseek was issued to a pipe. 

30 EROFS Read-only file system 

An attempt to modify a file or directory was made on a device mounted read-only. 
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31 EMLINK Too many links 

An attempt to make more than the maximum number of links (1000) to a file. 

32 EPIPE Broken pipe 

A write on a pipe for which there is no process to read the data. This condition normally generates 
a signal; the error is returned if the signal is ignored. 

33 EDOM Math argument 

The argument of a function in the math package (3M) is out of the domain of the function. 

34 ERANGE Result too large 

The value of a function in the math package (3M) is not representable within machine precision. 

35 ENOMSG No message of desired type 

An attempt was made to receive a message of a type that does not exist on the specified message 
queue; see msgop{ 2). 

36 EIDRM Identifier Removed 

This error is returned to processes that resume execution due to the removal of an identifier from 
the file system’s name space (see msgctUT), semctl(2), and shmctUT)). 

DEFINITIONS 
Process ID 

Each active process in the system is uniquely identified by a positive integer called a process ID. The range 
of this ID is from 0 to 30,000. 

Parent Process ID 

A new process is created by a currently active process; see forkd). The parent process ID of a process is 
the process ID of its creator. 

Process Group ID 

Each active process is a member of a process group that is identified by a positive integer called the process 
group ID. This ID is the process ID of the group leader. This grouping permits the signaling of related pro¬ 
cesses; see kill (2). 

Tty Group ID 

Each active process can be a member of a terminal group that is identified by a positive integer called the 
tty group ID. This grouping is used to terminate a group of related process upon termination of one of the 
processes in the group; see exit(2) and signal (2). 

Real User ID and Real Group ID 

Each user allowed on the system is identified by a positive integer called a real user ID. 

Each user is also a member of a group. The group is identified by a positive integer called the real group 
ID. 

An active process has a real user ID and real group ID that are set to the real user ID and real group ID, 
respectively, of the user responsible for the creation of the process. 

Effective User ID and Effective Group ID 

An active process has an effective user ID and an effective group ID that are used to determine file access 
permissions (see below). The effective user ID and effective group ID are equal to the process’s real user ID 
and real group ID respectively, unless the process or one of its ancestors evolved from a file that had the 
set-user-ID bit or set-group ID bit set; see exec( 2). 

Super-user 

A process is recognized as a super-user process and is granted special privileges if its effective user ID is 0. 

Special Processes 

The processes with a process ID of 0 and a process ID of 1 are special processes and are referred to as procO 
and prod. 
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ProcO is the scheduler. Prod is the initialization process (in it ). Prod is the ancestor of every other pro¬ 
cess in the system and is used to control the process structure. 

File Name. 

Names consisting of 1 to 14 characters may be used to name an ordinary file, special file or directory. 

These characters may be selected from the set of all character values excluding \0 (null) and the ASCII code 
for / (slash). 

Note that it is generally unwise to use *, ?, [, or ] as part of file names because of the special meaning 
attached to these characters by the shell. See sh( 1). Although permitted, it is advisable to avoid the use of 
unprintable characters in file names. 

Path Name and Path Prefix 

A path name is a null-terminated character string starting with an optional slash (/), followed by zero or 
more directory names separated by slashes, optionally followed by a file name. 

More precisely, a path name is a null-terminated character string constructed as follows: 

<path-name>::=<file-name> I <path-prefixxfile-name> I / 

<path-prefix>: :=<rtprefix> I /<rtprefix> 

<rtprefix>: :=<dirname>/1 <rtprefixxdirname>/ 

where <file-name> is a string of 1 to 14 characters other than the ASCII slash and null, and <dirname> is a 
string of 1 to 14 characters (other than the ASCII slash and null) that names a directory. 

If a path name begins with a slash, the path search begins at the root directory. Otherwise, the search 
begins from the current working directory. 

A slash by itself names the root directory. 

Unless specifically stated otherwise, the null path name is treated as if it named a non-existent file. 

Directory. 

Directory entries are called links. By convention, a directory contains at least two links,. and .., referred to 
as dot and dot-dot respectively. Dot refers to the directory itself and dot-dot refers to its parent directory. 

Root Directory and Current Working Directory. 

Each process has associated with it a concept of a root directory and a current working directory for the pur¬ 
pose of resolving path name searches. A process’s root directory need not be the root directory of the root 
file system. 

File Access Permissions. 

Read, write, and execute/search permissions on a file are granted to a process if one or more of the follow¬ 
ing are true: 

The process’s effective user ID is super-user. 

The process’s effective user ID matches the user ID of the owner of the file and the appropriate 
access bit of the “owner” portion (0700) of the file mode is set. 

The process’s effective user ID does not match the user ID of the owner of the file, and the 
process’s effective group ID matches the group of the file and the appropriate access bit of the 
“group” portion (070) of the file mode is set. 

The process’s effective user ID does not match the user ID of the owner of the file, and the 
process’s effective group ID does not match the group ID of the file, and the appropriate access bit 
of the “other” portion (07) of the file mode is set. 

Otherwise, the corresponding permissions are denied. 

Message Queue Identifier 

A message queue identifier (msqid) is a unique positive integer created by a msgget( 2) system call. Each 
msqid has a message queue and a data structure associated with it. The data structure is referred to as 
msqid ds and contains the following members: 
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struct 

ipc_perm msg perm; 

/* operation permission struct */ 

ushort 

msg qnum; 

/* number of msgs on q */ 

ushort 

msg qbytes; 

/* max number of bytes on q */ 

ushort 

msg lspid; 

/* pid of last msgsnd operation */ 

ushort 

msg lrpid; 

/* pid of last msgrcv operation */ 

time t 

msg stime; 

/* last msgsnd time */ 

time t 

msg rtime; 

/* last msgrcv time */ 

time t 

msg ctime; 

/* last change time */ 


/* Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1, 1970 */ 


Msgperm is a ipcperm structure that specifies the message operation permission (see below). This struc¬ 
ture includes the following members: 


ushort 

cuid; 

/* creator user id */ 

ushort 

cgid; 

/*■ creator group id */ 

ushort 

uid; 

/* user id */ 

ushort 

gid: 

/* group id *■/ 

ushort 

mode; 

/* r/w permission */ 


Msg qnum is the number of messages currently on the queue. Msg qbytes is the maximum number of 
bytes allowed on the queue. Msg lspid is the process id of the last process that performed a msgsnd 
operation. Msg lrpid is the process id of the last process that performed a msgrcv operation. Msg stime 
is the time of the last msgsnd operation, msg rtime is the time of the last msgrcv operation, and msg ctime 
is the time of the last msgctl( 2) operation that changed a member of the above structure. 

Message Operation Permissions. 

In the msgop(2) and msgctl{ 2) system call descriptions, the permission required for an operation is given as 
"{token}", where "token" is the type of permission needed interpreted as follows: 


00400 

Read by user 

00200 

Write by user 

00060 

Read, Write by group 

00006 

Read, Write by others 


Read and Write permissions on a msqid are granted to a process if one or more of the following are true: 

The process’s effective user ID is super-user. 

The process’s effective user ID matches msg_perm.[c]uid in the data structure associated with 
msqid and the appropriate bit of the “user” portion (0600) of msg perm.mode is set. 

The process’s effective user ID does not match msg_perm.[c]uid and the process’s effective group 
ID matches msg_perm.[c]gid and the appropriate bit of the “group” portion (060) of 

msg perm mode is set. 

The process’s effective user ID does not match msg_perm.[c]uid and the process’s effective group 
ID does not match msg_perm.[c]gid and the appropriate bit of the “other” portion (06) of 

msg perm mode is set. 

Otherwise, the corresponding permissions are denied. 

Semaphore Identifier 

A semaphore identifier (semid) is a unique positive integer created by a semget( 2) system call. Each semid 
has a set of semaphores and a data structure associated with it. The data structure is referred to as semid_ds 
and contains the following members: 

struct ipc_perm sem_perm; /* operation permission struct */ 

ushort sem nsems; /* number of sems in set */ 

time_t sem otime; /* last operation time */ 

time_t sem etime; /* last change time */ 
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/* Times measured in secs since */ 

/* 00:00:00 GMT, Jan. 1, 1970 */ 

Sem perm is a ipc_perm structure that specifies the semaphore operation permission (see below). This 
structure includes the following members: 


ushort 

cuid; 

/* creator user id */ 

ushort 

cgid; 

/*■ creator group id */ 

ushort 

uid; 

/* user id */ 

ushort 

gid: 

/* group id */ 

ushort 

mode; 

/* r/a permission */ 


The value of sem nsems is equal to the number of semaphores in the set. Each semaphore in the set is ref¬ 
erenced by a positive integer referred to as a semjuun. Sem num values run sequentially from 0 to the 
value of sem nsems minus 1. Sem otime is the time of the last semop( 2) operation, and sem ctime is the 
time of the last semctl{ 2) operation that changed a member of the above structure. 

A semaphore is a data structure that contains the following members: 


ushort 

semval; 

/* semaphore value */ 


short 

sempid; 

/* pid of last operation 

*/ 

ushort 

semncnt; 

/* # awaiting semval > cval */ 

ushort 

semzcnt; 

/* # awaiting semval = 

0 */ 


Semval is a non-negative integer. Sempid is equal to the process ID of the last process that performed a 
semaphore operation on this semaphore. Semncnt is a count of the number of processes that are currently 
suspended awaiting this semaphore’s semval to become greater than its current value. Semzcnt is a count 
of the number of processes that are currently suspended awaiting this semaphore’s semval to become zero. 

Semaphore Operation Permissions. 

In the semopi 2) and semctUT) system call descriptions, the permission required for an operation is given as 
"{token}", where "token" is the type of permission needed interpreted as follows: 


00400 

Read by user 

00200 

Alter by user 

00060 

Read, Alter by group 

00006 

Read, Alter by others 


Read and Alter permissions on a semid are granted to a process if one or more of the following are true: 

The process’s effective user ID is super-user. 

The process’s effective user ID matches sem_perm.[c]uid in the data structure associated with 
semid and the appropriate bit of the ‘ ‘user’ ’ portion (0600) of sem perm mode is set. 

The process’s effective user ID does not match sem perm.[c]uid and the process’s effective group 
ID matches sem_perm.[c]gid and the appropriate bit of the “group” portion (060) of 

sem perm.mode is set. 

The process’s effective user ID does not match sem_perm.[c]uid and the process’s effective group 
ID does not match sem_perm.[c]gid and the appropriate bit of the “other” portion (06) of 

sem perm.mode is set. 

Otherwise, the corresponding permissions are denied. 

Shared Memory Identifier 

A shared memory identifier (shmid) is a unique positive integer created by a shmget{ 2) system call. Each 
shmid has a segment of memory (referred to as a shared memory segment) and a data structure associated 
with it. The data structure is referred to as shmidjds and contains the following members: 

struct ipc_perm shm perm; /*■ operation permission struct *■/ 

int shm_segsz; /* size of segment */ 

ushort shm cpid; /* creator pid */ 
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ushort 

shm lpid; 

/* pid of last operation */ 

short 

shm nattch; 

/*■ number of current attaches */ 

time t 

shm atime; 

/* last attach time */ 

time t 

shm dtime; 

/* last detach time */ 

time t 

shm ctime; 

/* last change time *■/ 

/* Times measured in secs since */ 
/* 00:00:00 GMT, Jan. 1, 1970 */ 


Shm perm is a ipc_perm structure that specifies the shared memory operation permission (see below). 
This structure includes the following members: 


ushort 

cuid; 

/* creator user id */ 

ushort 

cgid; 

/* creator group id */ 

ushort 

uid; 

/*■ user id */ 

ushort 

gid: 

/* group id */ 

ushort 

mode; 

/* r/w permission */ 


Shm segsz specifies the size of the shared memory segment. Shm cpid is the process id of the process 
that created the shared memory identifier. Shm lpid is the process id of the last process that performed a 
shmop( 2) operation. Shm nattch is the number of processes that currently have this segment attached. 
Shm atime is the time of the last shmat operation, shm dtime is the time of the last shmdt operation, and 
shm ctime is the time of the last shmctl (2) operation that changed one of the members of the above struc¬ 
ture. 

Shared Memory Operation Permissions. 

In the shmop( 2) and shmctl{ 2) system call descriptions, the permission required for an operation is given as 
"{token}", where "token" is the type of permission needed interpreted as follows: 


00400 

Read by user 

00200 

Write by user 

00060 

Read, Write by group 

00006 

Read, Write by others 


Read and Write permissions on a shmid are granted to a process if one or more of the following are true: 

The process’s effective user ID is super-user. 

The process’s effective user ID matches shm_perm.[c]uid in the data structure associated with 
shmid and the appropriate bit of the ‘ ‘user’ ’ portion (0600) of shmperm mode is set. 

The process’s effective user ID does not match shm perm.[c]uid and the process’s effective 
group ID matches shm perm.[c]gid and the appropriate bit of the “group” portion (060) of 

shm perm mode is set. 

The process’s effective user ID does not match shm perm.[c]uid and the process’s effective 
group ID does not match shm perm.[c]gid and the appropriate bit of the “other” portion (06) of 

shm perm mode is set. 

Otherwise, the corresponding permissions are denied. 

SEE ALSO 

intro(3). 
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NAME 

access - determine accessibility of a file 
SYNOPSIS 

int access (path, amode) 
char *path; 
int amode; 

DESCRIPTION 

Path points to a path name naming a file. Access checks the named file for accessibility according to the 
bit pattern contained in amode , using the real user ID in place of the effective user ID and the real group ID 
in place of the effective group ID. The bit pattern contained in amode is constructed as follows: 

04 read 

02 write 

01 execute (search) 

00 check existence of file 

Access to the file is denied if one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

Read, write, or execute (search) permission is requested for a null path name. [ENOENT] 

The named file does not exist. [ENOENT] 

Search permission is denied on a component of the path prefix. [EACCES] 

Write access is requested for a file on a read-only file system. [EROFS] 

Write access is requested for a pure procedure (shared text) file that is being executed. [ETXTBSY] 

Permission bits of the file mode do not permit the requested access. [EACCES] 

Path points outside the process’s allocated address space. [EFAULT] 

The owner of a file has permission checked with respect to the ‘ ‘owner’ ’ read, write, and execute mode bits, 
members of the file’s group other than the owner have permissions checked with respect to the “group” 
mode bits, and all others have permissions checked with respect to the “other” mode bits. 

RETURN VALUE 

If the requested access is permitted, a value of 0 is returned. Otherwise, a value of -1 is returned and errno 
is set to indicate the error. 


SEE ALSO 

chmod(2), stat(2). 
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NAME 

acct - enable or disable process accounting 

SYNOPSIS 

int acct (path) 
char *path; 

DESCRIPTION 

Acct is used to enable or disable the system’s process accounting routine. If the routine is enabled, an 
accounting record will be written on an accounting file for each process that terminates. Termination can 
be caused by one of two things: an exit call or a signal; see exit(2) and signal(2). The effective user ID of 
the calling process must be super-user to use this call. 

Path points to a path name naming the accounting file. The accounting file format is given in acct(4). 

The accounting routine is enabled if path is non-zero and no errors occur during the system call. It is dis¬ 
abled if path is zero and no errors occur during the system call. 

Acct will fail if one or more of the following are true: 

The effective user ID of the calling process is not super-user. [EPERM] 

An attempt is being made to enable accounting when it is already enabled. [EBUSY] 

A component of the path prefix is not a directory. [ENOTDIR] 

One or more components of the accounting file’s path name do not exist. [ENOENT] 

A component of the path prefix denies search permission. [EACCES] 

The file named by path is not an ordinary file. [EACCES] 

Mode permission is denied for the named accounting file. [EACCES] 

The named file is a directory. [EISDIR] 

The named file resides on a read-only file system. [EROFS] 

Path points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

acct(4). 
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NAME 

alarm - set a process’s alarm clock 

SYNOPSIS 

unsigned alarm (sec) 
unsigned sec; 

DESCRIPTION 

Alarm instructs the calling process’s alarm clock to send the signal SIGALRM to the calling process after 
the number of real time seconds specified by sec have elapsed; see signal (2). 

Alarm requests are not stacked; successive calls reset the calling process’s alarm clock. 

If sec is 0, any previously made alarm request is canceled. 

RETURN VALUE 

Alarm returns the amount of time previously remaining in the calling process’s alarm clock. 

SEE ALSO 

pause(2), signal(2). 
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NAME 

brk, sbrk - change data segment space allocation 

SYNOPSIS 

int brk (endds) 
char endds; 

char *sbrk (incr) 
int incr; 

DESCRIPTION 

Brk and sbrk are used to change dynamically the amount of space allocated for the calling process’s data 
segment; see exec( 2). The change is made by resetting the process’s break value and allocating the appro¬ 
priate amount of space. The break value is the address of the first location beyond the end of the data seg¬ 
ment. The amount of allocated space increases as the break value increases. The newly allocated space is 
set to zero. 

Brk sets the break value to endds and changes the allocated space accordingly. 

Sbrk adds incr bytes to the break value and changes the allocated space accordingly. Incr can be negative, 
in which case the amount of allocated space is decreased. 

Brk and sbrk will fail without making any change in the allocated space if one or more of the following are 
true: 

Such a change would result in more space being allocated than is allowed by a system-imposed 
maximum (see ulimit{ 2)). [ENOMEM] 

Such a change would result in the break value being greater than or equal to the start address of 
any attached shared memory segment (see shmop( 2)). 

RETURN VALUE 

Upon successful completion, brk returns a value of 0 and sbrk returns the old break value. Otherwise, a 
value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2). 
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NAME 

chdir - change working directory 

SYNOPSIS 

int chdir (path) 
char *path; 

DESCRIPTION 

Path points to the path name of a directory. Chdir causes the named directory to become the current work¬ 
ing directory, the starting point for path searches for path names not beginning with /. 

Chdir will fail and the current working directory will be unchanged if one or more of the following are true: 

A component of the path name is not a directory. [ENOTDIR] 

The named directory does not exist. [ENOENT] 

Search permission is denied for any component of the path name. [EACCES] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

chroot(2). 
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NAME 

chmod - change mode of file 
SYNOPSIS 

int chmod (path, mode) 
char *path; 
int mode; 

DESCRIPTION 

Path points to a path name naming a file. Chmod sets the access permission portion of the named file’s 
mode according to the bit pattern contained in mode. 

Access permission bits are interpreted as follows: 

04000 Set user ID on execution. 

02000 Set group ID on execution. 

01000 Save text image after execution 
00400 Read by owner 
00200 Write by owner 

00100 Execute (or search if a directory) by owner 
00070 Read, write, execute (search) by group 
00007 Read, write, execute (search) by others 

The effective user ID of the process must match the owner of the file or be super-user to change the mode of 
a file. 

If the effective user ID of the process is not super-user, mode bit 01000 (save text image on execution) is 
cleared. 

If the effective user ID of the process is not super-user or the effective group ID of the process does not 
match the group ID of the file, mode bit 02000 (set group ID on execution) is cleared. 

If an executable file is prepared for sharing then mode bit 01000 prevents the system from abandoning the 
swap-space image of the program-text portion of the file when its last user terminates. Thus, when the next 
user of the file executes it, the text need not be read from the file system but can simply be swapped in, sav¬ 
ing time. 

Chmod will fail and the file mode will be unchanged if one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

The named file does not exist. [ENOENT] 

Search permission is denied on a component of the path prefix. [EACCES] 

The effective user ID does not match the owner of the file and the effective user ID is not super- 
user. [EPERM] 

The named file resides on a read-only file system. [EROFS] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

chown(2), mknod(2). 
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NAME 

chown - change owner and group of a file 
SYNOPSIS 

int chown (path, owner, group) 

char *path; 

int owner, group; 

DESCRIPTION 

Path points to a path name naming a file. The owner ID and group ID of the named file are set to the 
numeric values contained in owner and group respectively. 

Only processes with effective user ID equal to the file owner or super-user may change the ownership of a 
file. 

If chown is invoked by other than the super-user, the set-user-ID and set-group-ID bits of the file mode, 
04000 and 02000 respectively, will be cleared. 

Chown will fail and the owner and group of the named file will remain unchanged if one or more of the fol¬ 
lowing are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

The named file does not exist. [ENOENT] 

Search permission is denied on a component of the path prefix. [EACCES] 

The effective user ID does not match the owner of the file and the effective user ID is not super- 
user. [EPERM] 

The named file resides on a read-only file system. [EROFS] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

chmod(2). 
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NAME 

chroot - change root directory 

SYNOPSIS 

int chroot (path) 
char *path; 

DESCRIPTION 

Path points to a path name naming a directory. Chroot causes the named directory to become the root 
directory, the starting point for path searches for path names beginning with /. 

The effective user ID of the process must be super-user to change the root directory. 

The .. entry in the root directory is interpreted to mean the root directory itself. Thus, .. can not be used to 
access files outside the subtree rooted at the root directory. 

Chroot will fail and the root directory will remain unchanged if one or more of the following are true: 

Any component of the path name is not a directory. [ENOTDIR] 

The named directory does not exist. [ENOENT] 

The effective user ID is not super-user. [EPERM] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

chdir(2). 
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NAME 

close - close a file descriptor 

SYNOPSIS 

int close (Aides) 
int Aides; 

DESCRIPTION 

Fildes is a Ale descriptor obtained from a create open , dup,fcntl, or pipe system call. Close closes the Ale 
descriptor indicated by fildes. 

Close will fail if fildes is not a valid open Ale descriptor. [EBADF] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

creat(2), dup(2), exec(2), fcntl(2), open(2), pipe(2). 
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NAME 

creat - create a new file or rewrite an existing one 
SYNOPSIS 

int creat (path, mode) 
char *path; 
int mode; 

DESCRIPTION 

Creat creates a new ordinary file or prepares to rewrite an existing file named by the path name pointed to 
by path. 

If the file exists, the length is truncated to 0 and the mode and owner are unchanged. Otherwise, the file’s 
owner ID is set to the process’s effective user ID, the file’s group ID is set to the process’s effective group 
ID, and the low-order 12 bits of the file mode are set to the value of mode modified as follows: 

All bits set in the process’s file mode creation mask are cleared. See umask( 2). 

The “save text image after execution bit” of the mode is cleared. See chmod{ 2). 

Upon successful completion, a non-negative integer, namely the file descriptor, is returned and the file is 
open for writing, even if the mode does not permit writing. The file pointer is set to the beginning of the 
file. The file descriptor is set to remain open across exec system calls. See fcntl(2). No process may have 
more than 20 files open simultaneously. A new file may be created with a mode that forbids writing. 

Creat will fail if one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

A component of the path prefix does not exist. [ENOENT] 

Search permission is denied on a component of the path prefix. [EACCES] 

The path name is null. [ENOENT] 

The file does not exist and the directory in which the file is to be created does not permit writing. 
[EACCES] 

The named file resides or would reside on a read-only file system. [EROFS] 

The file is a pure procedure (shared text) file that is being executed. [ETXTBSY] 

The file exists and write permission is denied. [EACCES] 

The named file is an existing directory. [EISDIR] 

Twenty (20) file descriptors are currently open. [EMFILE] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a non-negative integer, namely the file descriptor, is returned. Otherwise, a 
value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

close(2), dup(2), lseek(2), open(2), read(2), umask(2), write(2). 
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NAME 

dup - duplicate an open file descriptor 

SYNOPSIS 

int dup (Aides) 
int Aides; 

DESCRIPTION 

Fildes is a Ale descriptor obtained from a creat, open, dup,fcntl, or pipe system call. Dup returns a new 
Ale descriptor having the following in common with the original: 

Same open Ale (or pipe). 

Same Ale pointer, (i.e., both Ale descriptors share one Ale pointer.) 

Same access mode (read, write or read/write). 

The new Ale descriptor is set to remain open across exec system calls. See/cnf/(2). 

The Ale descriptor returned is the lowest one available. 

Dup will fail if one or more of the following are true: 

Fildes is not a valid open Ale descriptor. [EBADF] 

Twenty (20) Ale descriptors are currently open. [EMFILE] 

RETURN VALUE 

Upon successful completion a non-negative integer, namely the Ale descriptor, is returned. Otherwise, a 
value of-1 is returned and errno is set to indicate the error. 


SEE ALSO 

creat(2), close(2), exec(2), fcntl(2), open(2), pipe(2). 
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NAME 

execl, execv, execle, execve, execlp, execvp - execute a file 
SYNOPSIS 

int execl (path, argO, argl,argn, 0) 
char *path, *arg0, *argl, : argn; 

int execv (path, argv) 
char *path, *argv[ ]; 

int execle (path, argO, argl,..., argn, 0, envp) 
char *path, *argO, *argl,..., *argn, *envp[ ]; 

int execve (path, argv, envp) 
char *path, *argv[ ], *envp[ ]; 

int execlp (file, argO, argl,..., argn, 0) 
char file, *argO, *argl,..., argn; 

int execvp (file, argv) 
char file, *argv[ ]; 

DESCRIPTION 

Exec in all its forms transforms the calling process into a new process. The new process is constructed 
from an ordinary, executable file called the new process file. This file consists of a header (see a.out( 4)), a 
text segment, and a data segment. The data segment contains an initialized portion and an uninitialized por¬ 
tion (bss). There can be no return from a successful exec because the calling process is overlaid by the new 
process. 

When a C program is executed, it is called as follows: 

main (argc, argv, envp) 
int argc; 

char **argv, **envp; 

where argc is the argument count and argv is an array of character pointers to the arguments themselves. 
As indicated, argc is conventionally at least one and the first member of the array points to a string contain¬ 
ing the name of the file. 

Path points to a path name that identifies the new process file. 

File points to the new process file. The path prefix for this file is obtained by a search of the directories 
passed as the environment line "PATH =" (see environ( 5)). The environment is supplied by the shell (see 
sh( D). 

ArgO , argl, ..., argn are pointers to null-terminated character strings. These strings constitute the argu¬ 
ment list available to the new process. By convention, at least argO must be present and point to a string 
that is the same as path (or its last component). 

Argv is an array of character pointers to null-terminated strings. These strings constitute the argument list 
available to the new process. By convention, argv must have at least one member, and it must point to a 
string that is the same as path (or its last component). Argv is terminated by a null pointer. 

Envp is an array of character pointers to null-terminated strings. These strings constitute the environment 
for the new process. Envp is terminated by a null pointer. For execl and execv , the C run-time start-off 
routine places a pointer to the calling process’s environment in the global cell: 

extern char **environ; 

and it is used to pass the calling process’s environment to the new process. 

File descriptors open in the calling process remain open in the new process, except for those whose 
close-on-exec flag is set; see fcntl( 2). For those file descriptors that remain open, the file pointer is 
unchanged. 


Page 1 



EXEC (2) 


EXEC (2) 


Signals set to terminate the calling process will be set to terminate the new process. Signals set to be 
ignored by the calling process will be set to be ignored by the new process. Signals set to be caught by the 
calling process will be set to terminate new process; see signal( 2). 

If the set-user-ID mode bit of the new process file is set (see chmod{ 2)), exec sets the effective user ID of 
the new process to the owner ID of the new process file. Similarly, if the set-group-ID mode bit of the new 
process file is set, the effective group ID of the new process is set to the group ID of the new process file. 
The real user ID and real group ID of the new process remain the same as those of the calling process. 

The shared memory segments attached to the calling process will not be attached to the new process (see 
shmopi 2)). 

Profiling is disabled for the new process; see profil(2). 

The new process also inherits the following attributes from the calling process: 

nice value (see nice( 2)) 

process ID 

parent process ID 

process group ID 

semadj values (see semopi 2)) 

tty group ID (see exit(2) and signal (2)) 

trace flag (see ptrace(2) request 0) 

time left until an alarm clock signal (see alarm {2)) 

current working directory 

root directory 

file mode creation mask (see umask( 2)) 

file size limit (see ulimit( 2)) 

utime, stime, cutime, and cstime (see times( 2)) 

Exec will fail and return to the calling process if one or more of the following are true: 

One or more components of the new process file's path name do not exist. [ENOENT] 

A component of the new process file’s path prefix is not a directory. [ENOTDIR] 

Search permission is denied for a directory listed in the new process file’s path prefix. [EACCES] 

The new process file is not an ordinary file. [EACCES] 

The new process file mode denies execution permission. [EACCES] 

The exec is not an execlp or execvp, and the new process file has the appropriate access permis¬ 
sion but an invalid magic number in its header. [ENOEXEC] 

The new process file is a pure procedure (shared text) file that is currently open for writing by 
some process. [ETXTBSY] 

The new process requires more memory than is allowed by the system-imposed maximum 
MAXMEM. [ENOMEM] 

The number of bytes in the new process’s argument list is greater than the system-imposed limit of 
5120 bytes. [E2BIG] 

The new process file is not as long as indicated by the size values in its header. [EFAULT] 

Path, argv, or envp point to an illegal address. [EFAULT] 

RETURN VALUE 

If exec returns to the calling process an error has occurred; the return value will be -1 and errno will be set 
to indicate the error. 

SEE ALSO 

exit(2), fork(2), environ(5). 
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NAME 

exit, _exit - terminate process 

SYNOPSIS 

void exit (status) 
int status; 
void exit (status) 
int status; 

DESCRIPTION 

Exit terminates the calling process with the following consequences: 

All of the file descriptors open in the calling process are closed. 

If the parent process of the calling process is executing a wait , it is notified of the calling process’s 
termination and the low order eight bits (i.e., bits 0377) of status are made available to it; see 
wait( 2). 

If the parent process of the calling process is not executing a wait, the calling process is trans¬ 
formed into a zombie process. A zombie process is a process that only occupies a slot in the pro¬ 
cess table, it has no other space allocated either in user or kernel space. The process table slot that 
it occupies is partially overlaid with time accounting information (see <sys/proc.h>) to be used by 
times. 

The parent process ID of all of the calling process’s existing child processes and zombie processes 
is set to 1. This means the initialization process (see intro( 2)) inherits each of these processes. 

Each attached shared memory segment is detached and the value of shm nattach in the data 
structure associated with its shared memory identifier is decremented by 1. 

For each semaphore for which the calling process has set a semadj value (see semop( 2)), that 
semadj value is added to the semval of the specified semaphore. 

If the process has a process, text, or data lock, an unlock is performed (see plock{ 2)). 

An accounting record is written on the accounting file if the system’s accounting routine is 
enabled; see acct (2). 

If the process ID, tty group ID, and process group ID of the calling process are equal, the SIGHUP 
signal is sent to each processes that has a process group ID equal to that of the calling process. 

The C function exit may cause cleanup actions before the process exits. The function _exit circumvents all 
cleanup. 

SEE ALSO 

signal(2), wait(2). 

WARNING 

See WARNING in signal(2). 
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NAME 

fcntl - file control 

SYNOPSIS 

#include <fcntl h> 

int fcntl (Aides, cmd, arg) 
int Aides, cmd, arg; 

DESCRIPTION 

Fcntl provides for control over open Ales. Fildes is an open Ale descriptor obtained from a create open, 
dup, fcntl, or pipe system call. 

The cmd s available are: 

FDUPFD Return a new Ale descriptor as follows: 

Lowest numbered available Ale descriptor greater than or equal to arg. 

Same open Ale (or pipe) as the original Ale. 

Same Ale pointer as the original Ale (i.e., both Ale descriptors share one Ale pointer). 

Same access mode (read, write or read/write). 

Same Ale status Aags (i.e., both Ale descriptors share the same Ale status Aags). 

The close-on-exec Aag associated with the new Ale descriptor is set to remain open across 
exec( 2) system calls. 

FGETFD Get the close-on-exec Aag associated with the Ale descriptor fildes. If the low-order bit is 0 
the Ale will remain open across exec, otherwise the Ale will be closed upon execution of exec. 

FSETFD Set the close-on-exec Aag associated with fildes to the low-order bit of arg (0 or 1 as above). 

FGETFL Get file status Aags. 

FSETFL Set file status Aags to arg. Only certain Aags can be set; see/cnf/(5). 

Fcntl will fail if one or more of the following are true: 

Fildes is not a valid open Ale descriptor. [EBADF] 

Cmd is F DUPFD and 20 Ale descriptors are currently open. [EMFILE] 

Cmd is F DUPFD and arg is negative or greater than 20. [EINVAL] 

RETURN VALUE 

Upon successful completion, the value returned depends on cmd as follows: 

F DUPFD A new Ale descriptor. 

F GETFD Value of Aag (only the low-order bit is deAned). 

F SETFD Value other than -1. 

F GETFL Value of Ale Aags. 

F SETFL Value other than -1. 

Otherwise, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

close(2), exec(2), open(2), fcntl(5). 
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NAME 

fork - create a new process 

SYNOPSIS 

int fork () 

The new process (child process) is an exact copy of the calling pro¬ 
child process inherits the following attributes from the parent pro- 


DESCRIPTION 

Fork causes creation of a new process, 
cess (parent process). This means the 
cess: 


environment 

close-on-exec flag (see exec( 2)) 

signal handling settings (i.e., SIGDFL, SIGING, function address) 

set-user-ID mode bit 

set-group-ID mode bit 

profiling on/off status 

nice value (see nice( 2)) 

all attached shared memory segments (see shmop(2)) 
process group ID 

tty group ID (see exit(2) and signal (2)) 

trace flag (see ptrace(2) request 0) 

time left until an alarm clock signal (see alarm (2)) 

current working directory 

root directory 

file mode creation mask (see umask( 2)) 
file size limit (see ulimit{ 2)) 

The child process differs from the parent process in the following ways: 

The child process has a unique process ID. 

The child process has a different parent process ID (i.e., the process ID of the parent process). 

The child process has its own copy of the parent's file descriptors. Each of the child’s file descrip¬ 
tors shares a common file pointer with the corresponding file descriptor of the parent. 

All semadj values are cleared (see semop(2)). 

Process locks, text locks and data locks are not inherited by the child (see plock( 2)). 

The child process’s utime, stime, cutime, and cstime are set to 0. 

Fork will fail and no child process will be created if one or more of the following are true: 

The system-imposed limit on the total number of processes under execution would be exceeded. 
[EAGAIN] 

The system-imposed limit on the total number of processes under execution by a single user would 
be exceeded. [EAGAIN] 

RETURN VALUE 

Upon successful completion, fork returns a value of 0 to the child process and returns the process ID of the 
child process to the parent process. Otherwise, a value of -1 is returned to the parent process, no child pro¬ 
cess is created, and errno is set to indicate the error. 

SEE ALSO 

exec(2), times(2), wait(2). 
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NAME 

getpid, getpgrp, getppid - get process, process group, and parent process IDs 

SYNOPSIS 

int getpid () 

int getpgrp () 

int getppid () 

DESCRIPTION 

Getpid returns the process ID of the calling process. 

Getpgrp returns the process group ID of the calling process. 

Getppid returns the parent process ID of the calling process. 

SEE ALSO 

exec(2), fork(2), intro(2), setpgrp(2), signal(2). 
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NAME 

getuid, geteuid, getgid, getegid - get real user, effective user, real group, and effective group IDs 

SYNOPSIS 

int getuid () 

int geteuid () 

int getgid () 

int getegid () 

DESCRIPTION 

Getuid returns the real user ID of the calling process. 

Geteuid returns the effective user ID of the calling process. 

Getgid returns the real group ID of the calling process. 

Getegid returns the effective group ID of the calling process. 

SEE ALSO 

intro(2), setuid(2). 
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NAME 

ioctl - control device 
SYNOPSIS 

ioctl (Aides, request, arg) 

DESCRIPTION 

Ioctl performs a variety of functions on character special files (devices). The writeups of various devices in 
Section 7 discuss how ioctl applies to them. 

Ioctl will fail if one or more of the following are true: 

Fildes is not a valid open file descriptor. [EBADF] 

Fildes is not associated with a character special device. [ENOTTY] 

Request or arg is not valid. See Section 7. [EINVAL] 

RETURN VALUE 

If an error has occurred, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

termio(7) in the UNIX System Administrator’s Manual. 
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NAME 

kill - send a signal to a process or a group of processes 

SYNOPSIS 

int kill (pid, sig) 
int pid, sig; 

DESCRIPTION 

Kill sends a signal to a process or a group of processes. The process or group of processes to which the sig¬ 
nal is to be sent is specified by pid. The signal that is to be sent is specified by sig and is either one from 
the list given in signal (2), or 0. If sig is 0 (the null signal), error checking is performed but no signal is 
actually sent. This can be used to check the validity of pid. 

The real or effective user ID of the sending process must match the real or effective user ID of the receiving 
process unless, the effective user ID of the sending process is super-user. 

The processes with a process ID of 0 and a process ID of 1 are special processes (see intro (2)) and will be 
referred to below as procO and prod respectively. 

If pid is greater than zero, sig will be sent to the process whose process ID is equal to pid. Pid may equal 
1 . 

If pid is 0, sig will be sent to all processes excluding procO and prod whose process group ID is equal to 
the process group ID of the sender. 

If pid is -1 and the effective user ID of the sender is not super-user, sig will be sent to all processes exclud¬ 
ing procO and prod whose real user ID is equal to the effective user ID of the sender. 

If pid is -1 and the effective user ID of the sender is super-user, sig will be sent to all processes excluding 
procO and prod. 

If pid is negative but not -1, sig will be sent to all processes whose process group ID is equal to the abso¬ 
lute value of pid. 

Kill will fail and no signal will be sent if one or more of the following are true: 

Sig is not a valid signal number. [EINVAL] 

No process can be found corresponding to that specified by pid. [ESRCH] 

The user ID of the sending process is not super-user, and its real or effective user ID does not 
match the real or effective user ID of the receiving process. [EPERM] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

kill(l), getpid(2), setpgrp(2), signal(2). 
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NAME 

link - link to a file 
SYNOPSIS 

int link (pathl, path2) 
char *pathl, *path2; 

DESCRIPTION 

Pathl points to a path name naming an existing file. Path2 points to a path name naming the new directory 
entry to be created. Link creates a new link (directory entry) for the existing file. 

Link will fail and no link will be created if one or more of the following are true: 

A component of either path prefix is not a directory. [ENOTDIR] 

A component of either path prefix does not exist. [ENOENT] 

A component of either path prefix denies search permission. [EACCES] 

The file named by pathl does not exist. [ENOENT] 

The link named by path2 exists. [EEXIST] 

The file named by pathl is a directory and the effective user ID is not super-user. [EPERM] 

The link named by path2 and the file named by pathl are on different logical devices (file sys¬ 
tems). [EXDEV] 

Path2 points to a null path name. [ENOENT] 

The requested link requires writing in a directory with a mode that denies write permission. 
[EACCES] 

The requested link requires writing in a directory on a read-only file system. [EROFS] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

unlink(2). 
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NAME 

lseek - move read/write file pointer 
SYNOPSIS 

long lseek (Aides, offset, whence) 
int Aides; 
long offset; 
int whence; 

DESCRIPTION 

Fildes is a Ale descriptor returned from a creat, open, dup, or fcntl system call. Lseek sets the Ale pointer 
associated with fiIdes as follows: 

If whence is 0, the pointer is set to offset bytes. 

If whence is 1, the pointer is set to its current location plus offset. 

If whence is 2, the pointer is set to the size of the Ale plus offset. 

Upon successful completion, the resulting pointer location as measured in bytes from the beginning of the 
Ale is returned. 

Lseek will fail and the Ale pointer will remain unchanged if one or more of the following are true: 

Fildes is not an open Ale descriptor. [EBADF] 

Fildes is associated with a pipe or Afo. [ESPIPE] 

Whence is not 0, 1 or 2. [EINVAL and SIGSYS signal] 

The resulting Ale pointer would be negative. [EINVAL] 

Some devices are incapable of seeking. The value of the Ale pointer associated with such a device is 
undeAned. 

RETURN VALUE 

Upon successful completion, a non-negative integer indicating the Ale pointer value is returned. Otherwise, 
a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

creat(2), dup(2), fcntl(2), open(2). 
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NAME 

maus - multiple-access-user-space (shared memory) operations 

SYNOPSIS 

#include <sys/fcntl.h> 

int getmaus (path, oflag) 
char *path; 
int oflag; 

int freemaus (mausdes) 
int mausdes; 

char enabmaus (mausdes) 
int mausdes; 

int dismaus (saddr) 
char saddr; 

char i svvitmaus (mausdes, saddr) 
int mausdes; 
char saddr; 

DESCRIPTION 

MAUS (Multiple Access User Space) is a dedicated portion of physical memory that is subdivided into logi¬ 
cal subsections. These subsections can be attached to the calling process’s data segment or released from 
its data segment with the following calls. 

Path points to a path name naming a special file that is one of the MAUS logical subsections. Getmaus 
opens a maus descriptor for the named file and sets the file status flag according to the value of oflag. Oflag 
is one of the following: 

O RDONLY Open for reading only. 

O WRONLY Open for writing only. 

O RDWR Open for reading and writing. 

No process may have more than eight (8) maus descriptors open simultaneously. 

The named file is opened unless one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

The named file does not exist. [ENOENT] 

The named file is not a maus special file. [EINVAL] 

A component of the path prefix denies search permission. [EACCES] 

Oflag permission is denied for the named file. [EACCES] 

Eight (8) maus descriptors are currently open. [EMFILE] 

The MAUS area associated with the special file does not exist. [ENXIO] 

Path points to an illegal address. [EFAULT] 

Freemaus closes the maus descriptor specified by mausdes. Note that if a maus descriptor has been 
enabled (see enabmaus below) it may still be closed: a MAUS file remains attached to a process’s data seg¬ 
ment until a dismaus (see below) is used to free it. 

Freemaus will fail if mausdes is not a valid open maus descriptor. [EBADF] 

Enabmaus attaches the MAUS file associated with mausdes to the data segment of the calling process. The 
file is attached starting at the first available 8k-byte boundary address beyond the current break value (see 
brk( 2)). Note that multiple enabmaus calls can be made with the same maus descriptor. Each call will 
attach the file at a different 8k-byte boundary address. 
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Enabmaus will fail and not attach the MAUS file if one or more of the following are true: 

Mausdes is not a valid open maus descriptor. [EBADF] 

No more 8k-byte boundary starting addresses are available. [ENOMEM] 

Dismaus frees from the calling process’s data segment the MAUS file that starts at the data segment address 
given by ( saddr - (saddr modulus 8192)). 

Dismaus will fail and not free the MAUS file if (saddr - (saddr modulus 8192)) is not the data segment 
starting address of a MAUS file. [EINVAL] 

Switmaus attaches the MAUS file associated with mausdes to the data segment of the calling process. The 
file is attached starting at the address given by (saddr - (saddr modulus 8192)). 

Switmaus will fail if one or more of the following are true: 

Mausdes is not a valid open maus descriptor. [EBADF] 

The value of (saddr - (saddr modulus 8192)) is not a legal 8k-byte boundary address above the 
current break value. [EINVAL] 

RETURN VALUES 

Upon successful completion, the return value is as follows: 

Getmaus returns a non-negative integer, namely a maus descriptor. 

Freemaus returns a value of 0. 

Enabmaus returns the data segment starting address of the attached MAUS file. 

Dismaus and switmaus return the maus descriptor previously associated with the data segment 
starting address given by (saddr - (saddr modulus 8192)) if one exists. Otherwise, a value of -2 
is returned. 

On other than successful completion, a value of -1 is returned with errno set to indicate the error. 
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NAME 

mknod - make a directory, or a special or ordinary file 
SYNOPSIS 

int mknod (path, mode, dev) 
char *path; 
int mode, dev; 

DESCRIPTION 

Mknod creates a new file named by the path name pointed to by path. The mode of the new file is initial¬ 
ized from mode. Where the value of mode is interpreted as follows: 

0170000 file type; one of the following: 

0010000 fifo special 
0020000 character special 
0040000 directory 
0060000 block special 
0100000 or 0000000 ordinary file 
0004000 set user ID on execution 
0002000 set group ID on execution 
0001000 save text image after execution 
0000777 access permissions; constructed from the following 
0000400 read by owner 
0000200 write by owner 

0000100 execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
0000007 read, write, execute (search) by others 

The file’s owner ID is set to the process’s effective user ID. The file’s group ID is set to the process’s effec¬ 
tive group ID. 

Values of mode other than those above are undefined and should not be used. The low-order 9 bits of mode 
are modified by the process’s file mode creation mask: all bits set in the process’s file mode creation mask 
are cleared. See umask( 2). If mode indicates a block or character special file, dev is a configuration depen¬ 
dent specification of a character or block I/O device. If mode does not indicate a block special or character 
special device, dev is ignored. 

Mknod may be invoked only by the super-user for file types other than FIFO special. 

Mknod will fail and the new file will not be created if one or more of the following are true: 

The process’s effective user ID is not super-user. [EPERM] 

A component of the path prefix is not a directory. [ENOTDIR] 

A component of the path prefix does not exist. [ENOENT] 

The directory in which the file is to be created is located on a read-only file system. [EROFS] 

The named file exists. [EEXIST] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

mkdir(l), chmod(2), exec(2), umask(2), fs(4). 
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NAME 

mount - mount a file system 
SYNOPSIS 

int mount (spec, dir, rwflag) 
char spec, *dir; 
int rwflag; 

DESCRIPTION 

Mount requests that a removable file system contained on the block special file identified by spec be 
mounted on the directory identified by dir. Spec and dir are pointers to path names. 

Upon successful completion, references to the file dir will refer to the root directory on the mounted file 
system. 

The low-order bit of rwflag is used to control write permission on the mounted file system; if 1, writing is 
forbidden, otherwise writing is permitted according to individual file accessibility. 

Mount may be invoked only by the super-user. 

Mount will fail if one or more of the following are true: 

The effective user ID is not super-user. [EPERM] 

Any of the named files does not exist. [ENOENT] 

A component of a path prefix is not a directory. [ENOTDIR] 

Spec is not a block special device. [ENOTBLK] 

The device associated with spec does not exist. [ENXIO] 

Dir is not a directory. [ENOTDIR] 

Spec or dir points outside the process’s allocated address space. 

Dir is currently mounted on, is someone’s current working 
[EBUSY] 

The device associated with spec is currently mounted. [EBUSY] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value 
to indicate the error. 

SEE ALSO 

umount(2). 


[EFAULT] 

directory or is otherwise busy. 


of -1 is returned and errno is set 
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NAME 

msgctl - message control operations 
SYNOPSIS 

#include <sys/types h> 

#include <sys/ipc h> 

#include <sys/msg h> 

int msgctl (msqid, cmd, buf) 
int msqid, cmd; 
struct msqid ds *buf; 

DESCRIPTION 

Msgctl provides a variety of message control operations as specified by cmd. The following cmd s are 
available: 

IPC STAT Place the current value of each member of the data structure associated with msqid into the 
structure pointed to by buf. The contents of this structure are defined in intro{ 2). {READ} 

IPC SET Set the value of the following members of the data structure associated with msqid to the cor¬ 
responding value found in the structure pointed to by buf: 
msg_perm.uid 
msg_perm.gid 

msg_perm mode /* only low 9 bits */ 
msgqbytes 

This cmd can only be executed by a process that has an effective user ID equal to either that of 
super user or to the value of msg perm.uid in the data structure associated with msqid. Only 
super user can raise the value of msg qbytes. 

IPC RMID Remove the message queue identifier specified by msqid from the system and destroy the mes¬ 
sage queue and data structure associated with it. This cmd can only be executed by a process 
that has an effective user ID equal to either that of super user or to the value of msgperm.uid 
in the data structure associated with msqid. 

Msgctl will fail if one or more of the following are true: 

Msqid is not a valid message queue identifier. [EINVAL] 

Cmd is not a valid command. [EINVAL] 

Cmd is equal to IPC STAT and {READ} operation permission is denied to the calling process (see 
intro (2)). [EACCES] 

Cmd is equal to IPC RMID or IPCSET and the effective user ID of the calling process is not equal 
to that of super user and it is not equal to the value of msg_perm.uid in the data structure associ¬ 
ated with msqid. [EPERM] 

Cmd is equal to IPC SET, an attempt is being made to increase to the value of msg qbytes, and 
the effective user ID of the calling process is not equal to that of super user. [EPERM] 

Bm/ points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

msgget(2), msgop(2). 
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NAME 

msgget - get message queue 

SYNOPSIS 

#include <sys/types h> 

#include <sys/ipc h> 

#include <sys/msg h> 

int msgget (key, msgflg) 
key t key; 
int msgflg; 

DESCRIPTION 

Msgget returns the message queue identifier associated with key. 

A message queue identifier and associated message queue and data structure (see intro (2)) are created for 
key if one of the following are true: 

Key is equal to IPC PRIVATE 

Key does not already have a message queue identifier associated with it, and ( msgflg & 
IPC CREAT) is “true”. 

Upon creation, the data structure associated with the new message queue identifier is initialized as follows: 

Msg perm.cuid, msg perm.uid, msg perm.cgid, and nisg perm.gid are set equal to the effec¬ 
tive user ID and effective group ID, respectively, of the calling process. 

The low-order 9 bits of msg perm.mode are set equal to the low-order 9 bits of msgflg. 

Msg qnum, msg lspid, msg lrpid, msg stime, and msg rtime are set equal to 0. 

Msg dime is set equal to the current time. 

Msg qbytes is set equal to the system limit. 

Msgget will fail if one or more of the following are true: 

A message queue identifier exists for key but operation permission (see intro{ 2)) as specified by 
the low-order 9 bits of msgflg would not be granted. [EACCES] 

A message queue identifier does not exist for key and ( msgflg & IPC GREAT) is “false”. 
[ENOENT] 

A message queue identifier is to be created but the system imposed limit on the maximum number 
of allowed message queue identifiers system wide would be exceeded. [ENOSPC] 

A message queue identifier exists for key but (( msgflg & IPC_CREAT) & ( msgflg & IPC_EXCL)) 
is “true”. [EEXIST] 

RETURN VALUE 

Upon successful completion, a non-negative integer, namely a message queue identifier is returned. Other¬ 
wise, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

msgctl(2), msgop(2). 


Page 1 




MSGOP(2) 


MSGOP(2) 


NAME 

msgop - message operations 

SYNOPSIS 

#include <sys/types h> 

#include <sys/ipc h> 

#include <sys/msg h> 

int msgsnd (msqid, msgp, msgsz, msgflg) 
int msqid; 

struct msgbuf *msgp; 
int msgsz, msgflg; 

int msgrcv (msqid, msgp, msgsz, msgtyp, msgflg) 
int msqid; 

struct msgbuf *msgp; 
int msgsz; 
long msgtyp; 
int msgflg; 

DESCRIPTION 

Msgsnd is used to send a message to the queue associated with the message queue identifier specified by 
msqid. {WRITE} Msgp points to a structure containing the message. This structure is composed of the fol¬ 
lowing members: 

long mtype; /* message type */ 

char mtext[]; /* message text */ 

Mtype is a positive integer that can be used by the receiving process for message selection (see msgrcv 
below). Mtext is any text of length msgsz bytes. Msgsz can range from 0 to a system imposed maximum. 

Msgflg specifies the action to be taken if one or more of the following are true: 

The number of bytes already on the queue is equal to msg qbytes (see intro ( 2)). 

The total number of messages on all queues system wide is equal to the system imposed limit. 

These actions are as follows: 

If ( msgflg & IPCNOWAIT) is “true”, the message will not be sent and the calling process will 
return immediately. 

If ( msgflg & IPC NOWAIT) is “false”, the calling process will suspend execution until one of the 
following occurs: 

The condition responsible for the suspension no longer exists, in which case the message 
is sent. 

Msqid is removed from the system (see msgctl( 2)). When this occurs, errno is set equal 
to EIDRM, and a value of-1 is returned. 

The calling process receives a signal that is to be caught. In this case the message is not 
sent and the calling process resumes execution in the manner prescribed in signal( 2)). 

Msgsnd will fail and no message will be sent if one or more of the following are true: 

Msqid is not a valid message queue identifier. [EINVAL] 

Operation permission is denied to the calling process (see intro (2)). [EACCES] 

Mtype is less than 1. [EINVAL] 

The message cannot be sent for one of the reasons cited above and ( msgflg & IPC NOWAIT) is 
“true”. [EAGAIN] 
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Msgsz is less than zero or greater than the system imposed limit. [EINVAL] 

Msgp points to an illegal address. [EFAULT] 

Upon successful completion, the following actions are taken with respect to the data structure associated 
with msqid (see intro (2)). 

Msg qnum is incremented by 1. 

Msg lspid is set equal to the process ID of the calling process. 

Msg stime is set equal to the current time. 

Msgrcv reads a message from the queue associated with the message queue identifier specified by msqid 
and places it in the structure pointed to by msgp. {READ) This structure is composed of the following 
members: 

long mtype; /* message type *■/ 

char mtext[]; /* message text */ 

Mtype is the received message’s type as specified by the sending process. Mtext is the text of the message. 
Msgsz specifies the size in bytes of mtext. The received message is truncated to msgsz bytes if it is larger 
than msgsz and (msgflg & MSGNOERROR) is “true”. The truncated part of the message is lost and no 
indication of the truncation is given to the calling process. 

Msgtyp specifies the type of message requested as follows: 

If msgtyp is equal to 0, the first message on the queue is received. 

If msgtyp is greater than 0, the first message of type msgtyp is received. 

If msgtyp is less than 0, the first message of the lowest type that is less than or equal to the abso¬ 
lute value of msgtyp is received. 

Msgflg specifies the action to be taken if a message of the desired type is not on the queue. These are as fol¬ 
lows: 

If ( msgflg & IPCNOWAIT) is “true”, the calling process will return immediately with a return 
value of-1 and errno set to ENOMSG. 

If ( msgflg & IPC NOWAIT) is “false”, the calling process will suspend execution until one of the 
following occurs: 

A message of the desired type is placed on the queue. 

Msqid is removed from the system. When this occurs, errno is set equal to EIDRM, and 
a value of-1 is returned. 

The calling process receives a signal that is to be caught. In this case a message is not 
received and the calling process resumes execution in the manner prescribed in 
signal ( 2)). 

Msgrcv will fail and no message will be received if one or more of the following are true: 

Msqid is not a valid message queue identifier. [EINVAL] 

Operation permission is denied to the calling process. [EACCES] 

Msgsz is less than 0. [EINVAL] 

Mtext is greater than msgsz and (msgflg & MSG NOERROR) is “false”. [E2BIG] 

The queue does not contain a message of the desired type and ( msgtyp & IPC NOWAIT) is 
“true”. [ENOMSG] 

Msgp points to an illegal address. [EFAULT] 

Upon successful completion, the following actions are taken with respect to the data structure associated 
with msqid (see intro (2)). 
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Msg qnum is decremented by 1. 

Msg lrpid is set equal to the process ID of the calling process. 

Msg rtime is set equal to the current time. 

RETURN VALUES 

If msgsnd or msgrcv return due to the receipt of a signal, a value of -1 is returned to the calling process and 
errno is set to EINTR. If they return due to removal of msqid from the system, a value of -1 is returned and 
errno is set to EIDRM. 

Upon successful completion, the return value is as follows: 

Msgsnd returns a value of 0. 

Msgrcv returns a value equal to the number of bytes actually placed into mtext. 

Otherwise, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

msgctl(2), msgget(2). 
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NAME 

nice - change priority of a process 

SYNOPSIS 

int nice (incr) 
int incr; 

DESCRIPTION 

Nice adds the value of incr to the nice value of the calling process. A process’s nice value is a positive 
number for which a more positive value results in lower CPU priority. 

A maximum nice value of 39 and a minimum nice value of 0 are imposed by the system. Requests for val¬ 
ues above or below these limits result in the nice value being set to the corresponding limit. 

Nice will fail and not change the nice value if incr is negative and the effective user ID of the calling pro¬ 
cess is not super-user. [EPERM] 

RETURN VALUE 

Upon successful completion, nice returns the new nice value minus 20. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 

SEE ALSO 

nice(l), exec(2). 
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NAME 

open - open for reading or writing 

SYNOPSIS 

#include <fcntl h> 

int open (path, oflag [, mode ]) 

char *path; 

int oflag, mode; 

DESCRIPTION 

Path points to a path name naming a file. Open opens a file descriptor for the named file and sets the file 
status flags according to the value of oflag. Oflag values are constructed by or-ing flags from the following 
list (only one of the first three flags below may be used): 

O RDONLY Open for reading only. 

OWRONEY Open for writing only. 

O RDWR Open for reading and writing. 

0_NDELAY This flag may affect subsequent reads and writes. See read(2) and write (2). 

When opening a FIFO with O RDONLY or O WRONLY set: 

If ONDELAY is set: 

An open for reading-only will return without delay. An open for writing-only will 
return an error if no process currently has the file open for reading. 

If O NDELAY is clear: 

An open for reading-only will block until a process opens the file for writing. An 
open for writing-only will block until a process opens the file for reading. 

When opening a file associated with a communication line: 

If O NDELAY is set: 

The open will return without waiting for carrier. 

If O NDELAY is clear: 

The open will block until carrier is present. 

O APPEND If set, the file pointer will be set to the end of the file prior to each write. 

O CREAT If the file exists, this flag has no effect. Otherwise, the file’s owner ID is set to the process’s 

effective user ID, the file’s group ID is set to the process’s effective group ID, and the low- 

order 12 bits of the file mode are set to the value of mode modified as follows (see 

creat( 2)): 

All bits set in the process’s file mode creation mask are cleared. See umask( 2). 

The “save text image after execution bit” of the mode is cleared. See chmod{ 2). 

O TRUNC If the file exists, its length is truncated to 0 and the mode and owner are unchanged. 

OJEXCL If O EXCL and O CREAT are set, open will fail if the file exists. 

Upon successful completion a non-negative integer, the file descriptor, is returned. 

The file pointer used to mark the current position within the file is set to the beginning of the file. 

The new file descriptor is set to remain open across exec system calls. Sce fcntKl). 

No process may have more than 20 file descriptors open simultaneously. 

The named file is opened unless one or more of the following are true: 
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A component of the path prefix is not a directory. [ENOTDIR] 

OCREAT is not set and the named file does not exist. [ENOENT] 

A component of the path prefix denies search permission. [EACCES] 

Oflag permission is denied for the named file. [EACCES] 

The named file is a directory and oflag is write or read/write. [EISDIR] 

The named file resides on a read-only file system and oflag is write or read/write. [EROFS] 

Twenty (20) file descriptors are currently open. [EMFILE] 

The named file is a character special or block special file, and the device associated with this spe¬ 
cial file does not exist. [ENXIO] 

The file is a pure procedure (shared text) file that is being executed and oflag is write or read/write. 
[ETXTBSY] 

Path points outside the process’s allocated address space. [EFAULT] 

O CREAT and O EXCL are set, and the named file exists. [EEXIST] 

O NDELAY is set, the named file is a FIFO, O WRONLY is set, and no process has the file open for 
reading. [ENXIO] 

RETURN VALUE 

Upon successful completion, a non-negative integer, namely a file descriptor, is returned. Otherwise, a 
value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

close(2), creat(2), dup(2), fcntl(2), lseek(2), read(2), write(2). 
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NAME 

pause - suspend process until signal 

SYNOPSIS 

pause () 

DESCRIPTION 

Pause suspends the calling process until it receives a signal. The signal must be one that is not currently 
set to be ignored by the calling process. 

If the signal causes termination of the calling process, pause will not return. 

If the signal is caught by the calling process and control is returned from the signal catching-function (see 
signal (2)), the calling process resumes execution from the point of suspension; with a return value of -1 
from pause and errno set to EINTR. 

SEE ALSO 

alarm(2), kill(2), signal(2), wait(2). 
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NAME 

pipe - create an interprocess channel 

SYNOPSIS 

int pipe (Aides) 
int Aldes[2]; 

DESCRIPTION 

Pipe creates an I/O mechanism called a pipe and returns two file descriptors, fildes[ 0] and fildes [I]. 
Fildes [0] is opened for reading and fildes[l] is opened for writing. 

Writes up to 5120 bytes of data are buffered by the pipe before the writing process is blocked. A read on 
file descriptor fildes [0] accesses the data written to fildes [1] on a first-in-first-out basis. 

No process may have more than 20 file descriptors open simultaneously. 

Pipe will fail if 19 or more file descriptors are currently open. [EMFILE] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

sh(l), read(2), write(2). 
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NAME 

plock - lock process, text, or data in memory 
SYNOPSIS 

#include <sys/lock h> 

int plock (op) 
int op; 

DESCRIPTION 

Plock allows the calling process to lock its text segment (text lock), its data segment (data lock), or both its 

text and data segments (process lock) into memory. Locked segments are immune to all routine swapping. 

Plock also allows these segments to be unlocked. The effective user ID of the calling process must be 
super-user to use this call. Op specifies the following: 

PROCLOCK - lock text & data segments into memory (process lock) 

TXTLOCK - lock text segment into memory (text lock) 

DATLOCK - lock data segment into memory (data lock) 

UNLOCK - remove locks 

Plock will fail and not perform the requested operation if one or more of the following are true: 

The effective user ID of the calling process is not super-user. [EPERM] 

Op is equal to PROCLOCK and a process lock, a text lock, or a data lock already exists on the 
calling process. [EINVAL] 

Op is equal to TXTLOCK and a text lock, or a process lock already exists on the calling process. 
[EINVAL] 

Op is equal to DATLOCK and a data lock, or a process lock already exists on the calling process. 
[EINVAL] 

Op is equal to UNLOCK and no type of lock exists on the calling process. [EINVAL] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned to the calling process. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 


SEE ALSO 

exec(2), exit(2), fork(2). 
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NAME 

profil - execution time profile 
SYNOPSIS 

void profil (buff, bufsiz, offset, scale) 
char *buff; 

int bufsiz, offset, scale; 

DESCRIPTION 

Buff points to an area of core whose length (in bytes) is given by bufsiz. After this call, the user’s program 
counter (pc) is examined each clock tick (60th second); offset is subtracted from it, and the result multiplied 
by scale. If the resulting number corresponds to a word inside buff , that word is incremented. 

The scale is interpreted as an unsigned, fixed-point fraction with binary point at the left: 0177777 (octal) 
gives a 1-1 mapping of pc's to words in buff; 077777 (octal) maps each pair of instruction words together. 
02(8) maps all instructions onto the beginning of buff (producing a non-interrupting core clock). 

Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by giving a bufsiz of 0. 
Profiling is turned off when an exec is executed, but remains on in child and parent both after a fork. 
Profiling will be turned off if an update in buff would cause a memory fault. 

RETURN VALUE 

Not defined. 

SEE ALSO 

profd), monitor(3C). 
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NAME 

ptrace - process trace 

SYNOPSIS 

int ptrace (request, pid, addr, data); 
int request, pid, addr, data; 

DESCRIPTION 

Ptrace provides a means by which a parent process may control the execution of a child process. Its pri¬ 
mary use is for the implementation of breakpoint debugging; see sdb{ 1). The child process behaves nor¬ 
mally until it encounters a signal (see signal (2) for the list), at which time it enters a stopped state and its 
parent is notified via wait( 2). When the child is in the stopped state, its parent can examine and modify its 
“core image” using ptrace. Also, the parent can cause the child either to terminate or continue, with the 
possibility of ignoring the signal that caused it to stop. 

The request argument determines the precise action to be taken by ptrace and is one of the following: 

0 This request must be issued by the child process if it is to be traced by its parent. It turns on 
the child's trace flag that stipulates that the child should be left in a stopped state upon 
receipt of a signal rather than the state specified by func; see signal( 2). The pid, addr, and 
data arguments are ignored, and a return value is not defined for this request. Peculiar 
results will ensue if the parent does not expect to trace the child. 

The remainder of the requests can only be used by the parent process. For each, pid is the process ID of the 
child. The child must be in a stopped state before these requests are made. 

1, 2 With these requests, the word at location addr in the address space of the child is returned to 
the parent process. If I and D space are separated (as on PDP-1 Is), request 1 returns a word 
from I space, and request 2 returns a word from D space. If I and D space are not separated 
(as on the 3B20S and VAX-11/780), either request 1 or request 2 may be used with equal 
results. The data argument is ignored. These two requests will fail if addr is not the start 
address of a word, in which case a value of -1 is returned to the parent process and the 
parent’s errno is set to EIO. 

3 With this request, the word at location addr in the child’s USER area in the system’s address 
space (see <sys/user h>) is returned to the parent process. Addresses in this area range from 
0 to 1024 on the PDP-1 Is and 0 to 2048 on the 3B20S and VAX. The data argument is 
ignored. This request will fail if addr is not the start address of a word or is outside the 
USER area, in which case a value of -1 is returned to the parent process and the parent’s 
errno is set to EIO. 

4, 5 With these requests, the value given by the data argument is written into the address space 
of the child at location addr. If I and D space are separated (as on PDP-1 Is), request 4 
writes a word into I space, and request 5 writes a word into D space. If I and D space are 
not separated (as on the 3B20S and VAX), either request 4 or request 5 may be used with 
equal results. Upon successful completion, the value written into the address space of the 
child is returned to the parent. These two requests will fail if addr is a location in a pure 
procedure space and another process is executing in that space, or addr is not the start 
address of a word. Upon failure a value of -1 is returned to the parent process and the 
parent’s errno is set to EIO. 

6 With this request, a few entries in the child’s USER area can be written. Data gives the 
value that is to be written and addr is the location of the entry. The few entries that can be 
written are: 

the general registers (i.e., registers 0-11 on the 3B20S, registers 0-7 on PDP-1 Is, 
and registers 0-15 on the VAX) 

the condition codes of the Processor Status Word on the 3B20S . 


Page 1 



PTRACE(2) 


PTRACE(2) 


the floating point status register and six floating point registers on PDP-1 Is 

certain bits of the Processor Status Word on PDP-1 Is (i.e, bits 0-4, and 8-11) 

certain bits of the Processor Status Longword on the VAX (i.e., bits 0-7, 16-20, 
and 30-31) 

7 This request causes the child to resume execution. If the data argument is 0, all pending 
signals including the one that caused the child to stop are canceled before it resumes execu¬ 
tion. If the data argument is a valid signal number, the child resumes execution as if it had 
incurred that signal and any other pending signals are canceled. The addr argument must be 
equal to 1 for this request. Upon successful completion, the value of data is returned to the 
parent. This request will fail if data is not 0 or a valid signal number, in which case a value 
of -1 is returned to the parent process and the parent’s errno is set to EIO. 

8 This request causes the child to terminate with the same consequences as exit{ 2). 

9 This request sets the trace bit in the Processor Status Word of the child (i.e., bit 4 on PDP- 
1 Is; bit 30 on the VAX) and then executes the same steps as listed above for request 7. The 
trace bit causes an interrupt upon completion of one machine instruction. This effectively 
allows single stepping of the child. On the 3B20S there is no trace bit and this request 
returns an error. 

Note: the trace bit remains set after an interrupt on PDP-1 Is but is turned off after an inter¬ 
rupt on the VAX. 

To forestall possible fraud, ptrace inhibits the set-user-id facility on subsequent exec( 2) calls. If a traced 

process calls exec , it will stop before executing the first instruction of the new image showing signal 

SIGTRAP. 

GENERAL ERRORS 

Ptrace will in general fail if one or more of the following are true: 

Request is an illegal number. [EIO] 

Pid identifies a child that does not exist or has not executed a ptrace with request 0. [ESRCH] 

SEE ALSO 

sdb(l), exec(2), signal(2), wait(2). 
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NAME 

read - read from file 
SYNOPSIS 

int read (Aides, buf, nbyte) 
int Aides; 
char *buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a Ale descriptor obtained from a creat, open, dup,fcntl, or pipe system call. 

Read attempts to read nbyte bytes from the Ale associated with fildes into the buffer pointed to by buf. 

On devices capable of seeking, the read starts at a position in the Ale given by the Ale pointer associated 
with fildes. Upon return from read, the Ale pointer is incremented by the number of bytes actually read. 

Devices that are incapable of seeking always read from the current position. The value of a Ale pointer 
associated with such a Ale is undeAned. 

Upon successful completion, read returns the number of bytes actually read and placed in the buffer; this 
number may be less than nbyte if the Ale is associated with a communication line (see ioctl{ 2) and 
termio (7)), or if the number of bytes left in the Ale is less than nbyte bytes. A value of 0 is returned when 
an end-of-Ale has been reached. 

When attempting to read from an empty pipe (or FIFO): 

If ONDELAY is set, the read will return a 0. 

If O NDELAY is clear, the read will block until data is written to the Ale or the Ale is no longer 
open for writing. 

When attempting to read a Ale associated with a tty that has no data currently available: 

If O NDELAY is set, the read will return a 0. 

If O NDELAY is clear, the read will block until data becomes available. 

Read will fail if one or more of the following are true: 

Fildes is not a valid Ale descriptor open for reading. [EBADF] 

Buf points outside the allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion a non-negative integer is returned indicating the number of bytes actually read. 
Otherwise, a -1 is returned and errno is set to indicate the error. 

SEE ALSO 

creat(2), dup(2), fcntl(2), ioctl(2), open(2), pipe(2), termio(7). 
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NAME 

semctl - semaphore control operations 
SYNOPSIS 

#include <sys/types h> 

#include <sys/ipc h> 

#include <sys/sem.h> 

int semctl (semid, semnum, cmd, arg) 
int semid, cmd; 
int semnum; 
union semun { 
int val; 

struct semid ds *buf; 
ushort array [ ]; 

} arg; 

DESCRIPTION 

Semctl provides a variety of semaphore control operations as specified by cmd. 

The following cmds are executed with respect to the semaphore specified by semid and semnum: 

GET VAL Return the value of semval (see in tro (2)). {READ} 

SETVAL Set the value of semval to arg.val. {ALTER} When this cmd is successfully exe¬ 
cuted the semadj value corresponding to the specified semaphore in all processes is 
cleared. 

GETPID Return the value of sempid. {READ} 

GETNCNT Return the value of semncnt. {READ} 

GETZCNT Return the value of semzcnt. {READ} 

The following cmd s return and set, respectively, every semval in the set of semaphores. 

GETALL Place semvals into array pointed to by arg.array. {READ} 

SETALL Set semvals according to the array pointed to by arg.array. {ALTER} When this 
cmd is successfully executed the semadj values corresponding to each specified 
semaphore in all processes are cleared. 

The following cmd s are also available: 

IPC STAT Place the current value of each member of the data structure associated with semid 
into the structure pointed to by arg.buf. The contents of this structure are defined in 
intro (2). {READ} 

IPC SET Set the value of the following members of the data structure associated with semid 
to the corresponding value found in the structure pointed to by arg.buf: 

sem perm.uid 
sem perm.gid 

sem perm mode /* only low 9 bits */ 

This cmd can only be executed by a process that has an effective user ID equal to 
either that of super user or to the value of sem perm.uid in the data structure asso¬ 
ciated with semid. 

IPC RMID Remove the semaphore identifier specified by semid from the system and destroy 
the set of semaphores and data structure associated with it. This cmd can only be 
executed by a process that has an effective user ID equal to either that of super user 
or to the value of sem perm.uid in the data structure associated with semid. 
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SemctI will fail if one or more of the following are true: 

Semid is not a valid semaphore identifier. [EINVAL] 

Semnum is less than zero or greater than sent nsems. [EINVAL] 

Cmd is not a valid command. [EINVAL] 

Operation permission is denied to the calling process (see intro (2)). [EACCES] 

Cmd is SETVAL or SETALL and the value to which semval is to be set is greater than the 
system imposed maximum. [ERANGE] 

Cmd is equal to I PC RMII) or IPCSET and the effective user ID of the calling process is 
not equal to that of super user and it is not equal to the value of sem_perm.uid in the data 
structure associated with semid. [EPERM] 

Arg.buf points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, the value returned depends on cmd as follows: 

GETVAL The value of semval. 

GETPID The value of sempid. 

GETNCNT The value of semncnt. 

GETZCNT The value of semzcnt. 

All others A value of 0. 

Otherwise, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

semget(2), semop(2). 
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NAME 

semget - get set of semaphores 

SYNOPSIS 

#include <sys/types h> 

#include <sys/ipc h> 

#include <sys/sem.h> 

int semget (key, nsems, semflg) 

key t key; 

int nsems, semflg; 

DESCRIPTION 

Semget returns the semaphore identifier associated with key. 

A semaphore identifier and associated data structure and set containing nsems semaphores (see intro{ 2)) are 
created for key if one of the following are true: 

Key is equal to IPC PRIVATE 

Key does not already have a semaphore identifier associated with it, and ( semflg & IPCCREAT) is 
“true”. 

Upon creation, the data structure associated with the new semaphore identifier is initialized as follows: 

Sem perm.cuid, sem perm.uid, sem perm.cgid, and sem perm.gid are set equal to the effec¬ 
tive user ID and effective group ID, respectively, of the calling process. 

The low-order 9 bits of sem perm.mode are set equal to the low-order 9 bits of semflg. 

Sem nsems is set equal to the value of nsems. 

Sem otime is set equal to 0 and sem ctime is set equal to the current time. 

Semget will fail if one or more of the following are true: 

Nsems is either less than or equal to zero or greater than the system imposed limit. [EINVAL] 

A semaphore identifier exists for key but operation permission (see intro{ 2)) as specified by the 
low-order 9 bits of semflg would not be granted. [EACCES] 

A semaphore identifier exists for key but the number of semaphores in the set associated with it is 
less than nsems and nsems is not equal to zero. [EINVAL] 

A semaphore identifier does not exist for key and (semflg & IPC CREAT) is “false”. [ENOENT] 

A semaphore identifier is to be created but the system imposed limit on the maximum number of 
allowed semaphore identifiers system wide would be exceeded. [ENOSPC] 

A semaphore identifier is to be created but the system imposed limit on the maximum number of 
allowed semaphores system wide would be exceeded. [ENOSPC] 

A semaphore identifier exists for key but ( ( semflg & IPC CREAT) & ( semflg & IPC EXCL) ) is 
“true”. [EEXIST] 

RETURN VALUE 

Upon successful completion, a non-negative integer, namely a semaphore identifier is returned. Otherwise, 
a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

semctl(2), semop(2). 
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NAME 

semop - semaphore operations 
SYNOPSIS 

#include <sys/types h> 

#include <sys/ipc h> 

#include <sys/sem.h> 

int semop (semid, sops, nsops) 
int semid; 

struct sembuf (*sops)[]; 
int nsops; 

DESCRIPTION 

Semop is used to atomically perform an array of semaphore operations on the set of semaphores associated 
with the semaphore identifier specified by semid. Sops is a pointer to the array of semaphore-operation 
structures. Nsops is the number of such structures in the array. The contents of each structure includes the 
following members: 


short 

sem num; 

/* semaphore number */ 

short 

sem op; 

/* semaphore operation */ 

short 

sem fig; 

/* operation flags */ 


Each semaphore operation specified by sem op is performed on the corresponding semaphore specified by 
semid and semnum. 

Sem op specifies one of three semaphore operations as follows: 

If semop is a negative integer, one of the following will occur: {ALTER} 

If semval (see intro (2)) is greater than or equal to the absolute value of sem_op , the 
absolute value of sem_op is subtracted from semval. Also, if ( semjlg & SEMUNDO) 
is “true”, the absolute value of sem_op is added to the calling process’s semadj value 
(see exit(2)) for the specified semaphore. 

If semval is less than the absolute value of sem_op and (semjlg & IPCNOWAIT) is 
“true”, semop will return immediately. 

If semval is less than the absolute value of sem_op and (semjlg & IPC NOWAIT) is 
“false”, semop will increment the semncnt associated with the specified semaphore and 
suspend execution of the calling process until one of the following occurs: 

Semval becomes greater than or equal to the absolute value of sem_op. When this 
occurs, the value of semncnt associated with the specified semaphore is decremented, 
the absolute value of sem op is subtracted from semval and, if (semjlg & 
SEM UNDO) is “true”, the absolute value of sem op is added to the calling process’s 
semadj value for the specified semaphore. 

The semid for which the calling process is awaiting action is removed from the system 
(see semctl( 2)). When this occurs, errno is set equal to EIDRM, and a value of -1 is 
returned. 

The calling process receives a signal that is to be caught. When this occurs, the value 
of semncnt associated with the specified semaphore is decremented, and the calling pro¬ 
cess resumes execution in the manner prescribed in signal (2). 

If sem_op is a positive integer, the value of sem_op is added to semval and, if (sem jlg & 
SEM_UNDO) is “true”, the value of sem_op is subtracted from the calling process’s semadj 
value for the specified semaphore. {ALTER} 

If sem op is zero, one of the following will occur: {READ} 
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If semval is zero, semop will return immediately. 

If semval is not equal to zero and ( semjtg & IPCNOWAIT) is “true”, semop will 
return immediately. 

If semval is not equal to zero and ( semjlg & IPC NOWAIT) is “false”, semop will 
increment the semzcnt associated with the specified semaphore and suspend execution of 
the calling process until one of the following occurs: 

Semval becomes zero, at which time the value of semzcnt associated with the specified 
semaphore is decremented. 

The semid for which the calling process is awaiting action is removed from the system. 
When this occurs, errno is set equal to EIDRM, and a value of-1 is returned. 

The calling process receives a signal that is to be caught. When this occurs, the value 
of semzcnt associated with the specified semaphore is decremented, and the calling pro¬ 
cess resumes execution in the manner prescribed in signal( 2). 

Semop will fail if one or more of the following are true for any of the semaphore operations specified by 
sops: 

Semid is not a valid semaphore identifier. [EINVAL] 

Semjium is less than zero or greater than or equal to the number of semaphores in the set associ¬ 
ated with semid. [EFBIG] 

Nsops is greater than the system imposed maximum. [E2BIG] 

Operation permission is denied to the calling process (see intro( 2)). [EACCES] 

The operation would result in suspension of the calling process but (sem jlg & IPC NOWAIT) is 
“true”. [EAGAIN] 

The limit on the number of individual processes requesting an SEMUNDO would be exceeded. 
[ENOSPC] 

The number of individual semaphores for which the calling process requests a SEM UNDO would 
exceed the limit. [EINVAL] 

An operation would cause a semval to overflow the system imposed limit. [ERANGE] 

An operation would cause a semadj value to overflow the system imposed limit. [ERANGE] 

Sops points to an illegal address. [EFAULT] 

Upon successful completion, the value of sempid for each semaphore specified in the array pointed to by 
sops is set equal to the process ID of the calling process. 

RETURN VALUE 

If semop returns due to the receipt of a signal, a value of -1 is returned to the calling process and errno is 
set to EINTR. If it returns due to the removal of a semid from the system, a value of -1 is returned and 
errno is set to EIDRM. 

Upon successful completion, the value of semval at the time of the call for the last operation in the array 
pointed to by sops is returned. Otherwise, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2), semctl(2), semget(2). 
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NAME 

setpgrp - set process group ID 

SYNOPSIS 

int setpgrp () 

DESCRIPTION 

Setpgrp sets the process group ID of the calling process to the process ID of the calling process and returns 
the new process group ID. 

RETURN VALUE 

Setpgrp returns the value of the new process group ID. 

SEE ALSO 

exec(2), fork(2), getpid(2), intro(2), kill(2), signal(2). 
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NAME 

setuid, setgid - set user and group IDs 

SYNOPSIS 

int setuid (uid) 
int uid; 

int setgid (gid) 
int gid; 

DESCRIPTION 

Setuid ( setgid ) is used to set the real user (group ) ID and effective user (group) ID of the calling process. 

If the effective user ID of the calling process is super-user, the real user (group) ID and effective user 
(group) ID are set to uid (gid). 

If the effective user ID of the calling process is not super-user, but its real user (group) ID is equal to uid 
(gid), the effective user (group) ID is set to uid (gid). 

Setuid (setgid) will fail if the real user (group) ID of the calling process is not equal to uid (gid) and its 
effective user ID is not super-user. [EPERM] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

getuid(2), intro(2). 
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NAME 

shmctl - shared memory control operations 

SYNOPSIS 

#include <sys/types h> 

#include <sys/ipc h> 

#include <sys/shm h> 

int shmctl (shmid, cmd, buf) 
int shmid, cmd; 
struct shmid ds *buf; 

DESCRIPTION 

Shmctl provides a variety of shared memory control operations as specified by cmd. The following cmd s 
are available: 

IPC STAT Place the current value of each member of the data structure associated with shmid 
into the structure pointed to by buf. The contents of this structure are defined in 
intro(2). {READ} 

IPC SET Set the value of the following members of the data structure associated with shmid to 
the corresponding value found in the structure pointed to by buf: 
shm_perm.uid 
shm_perm.gid 

shm_perm.mode /* only low 9 bits */ 

This cmd can only be executed by a process that has an effective user ID equal to 
either that of super user or to the value of shm perm.uid in the data structure associ¬ 
ated with shmid. 

IPC RMID Remove the shared memory identifier specified by shmid from the system and 
destroy the shared memory segment and data structure associated with it. This cmd 
can only be executed by a process that has an effective user ID equal to either that of 
super user or to the value of shm perm.uid in the data structure associated with 
shmid. 

Shmctl will fail if one or more of the following are true: 

Shmid is not a valid shared memory identifier. [EINVAL] 

Cmd is not a valid command. [EINVAL] 

Cmd is equal to IPCSTAT and {READ} operation permission is denied to the calling pro¬ 
cess (see intro (2)). [EACCES] 

Cmd is equal to IPC RMII) or IPCSET and the effective user ID of the calling process is 
not equal to that of super user and it is not equal to the value of shm perm.uid in the 
data structure associated with shmid. [EPERM] 

Buf points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

shmget(2), shmop(2). 
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NAME 

shmget - get shared memory segment 

SYNOPSIS 

#include <sys/types h> 

#include <sys/ipc h> 

#include <sys/shm h> 

int shmget (key, size, shmflg) 

key t key; 

int size, shmflg; 

DESCRIPTION 

Shmget returns the shared memory identifier associated with key. 

A shared memory identifier and associated data structure and shared memory segment of size size bytes 
(see intro{ 2)) are created for key if one of the following are true: 

Key is equal to IPC PRIVATE 

Key does not already have a shared memory identifier associated with it, and ( shmflg & 
IPC CREAT) is “true”. 

Upon creation, the data structure associated with the new shared memory identifier is initialized as follows: 

Shm perm.cuid, shm perm.uid, shm perm.cgid, and shm perm.gid are set equal to the effec¬ 
tive user ID and effective group ID, respectively, of the calling process. 

The low-order 9 bits of shm perm mode are set equal to the low-order 9 bits of shmflg. 
Shm segsz is set equal to the value of size. 

Shmlpid, shm nattch, shm atime, and shm dtime are set equal to 0. 

Shm ctime is set equal to the current time. 

Shmget will fail if one or more of the following are true: 

Size is less than the system imposed minimum or greater than the system imposed maximum. 
[EINVAL] 

A shared memory identifier exists for key but operation permission (see intro (2)) as specified by 
the low-order 9 bits of shmflg would not be granted. [EACCES] 

A shared memory identifier exists for key but the size of the segment associated with it is less than 
size and size is not equal to zero. [EINVAL] 

A shared memory identifier does not exist for key and ( shmflg & IPC CREAT) is “false”. 
[ENOENT] 

A shared memory identifier is to be created but the system imposed limit on the maximum number 
of allowed shared memory identifiers system wide would be exceeded. [ENOSPC] 

A shared memory identifier and associated shared memory segment are to be created but the 
amount of available physical memory is not sufficient to fill the request. [ENOMEM] 

A shared memory identifier exists for key but (( shmflg & IPC CREAT) & ( shmflg & IPC EXCL)) 
is “true”. [EEXIST] 

RETURN VALUE 

Upon successful completion, a non-negative integer, namely a shared memory identifier is returned. Other¬ 
wise, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

shmctl(2), shmop(2). 
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NAME 

shmop - shared memory operations 
SYNOPSIS 

#include <sys/types h> 

#include <sys/ipc h> 

#include <sys/shm h> 

char *shmat (shmid, shmaddr, shmflg) 
int shmid; 
char * shmaddr 
int shmflg; 

int shmdt (shmaddr) 
char *shmaddr 

DESCRIPTION 

Shmat attaches the shared memory segment associated with the shared memory identifier specified by 
shmid to the data segment of the calling process. The segment is attached at the address specified by one of 
the following criteria: 

If shmaddr is equal to zero, the segment is attached at the first available address as selected by the 
system. 

If shmaddr is not equal to zero and ( shmflg & SHM RND) is “true”, the segment is attached at the 
address given by ( shmaddr - (shmaddr modulus SHMLBA)). 

If shmaddr is not equal to zero and (shmflg & SHM RND) is “false”, the segment is attached at 
the address given by shmaddr. 

The segment is attached for reading if (shmflg & SHMRDONLY) is “true” {READ}, otherwise it is 
attached for reading and writing {READ/WRITE}. 

Shmat will fail and not attach the shared memory segment if one or more of the following are true: 

Shmid is not a valid shared memory identifier. [EINVAL] 

Operation permission is denied to the calling process (see intro( 2)). [EACCES] 

The available data space is not large enough to accommodate the shared memory segment. 
[ENOMEM] 

Shmaddr is not equal to zero, and the value of (shmaddr - (shmaddr modulus SHMLBA)) is an 
illegal address. [EINVAL] 

Shmaddr is not equal to zero, (shmflg & SHM RND) is “false”, and the value of shmaddr is an 
illegal address. [EINVAL] 

The number of shared memory segments attached to the calling process would exceed the system 
imposed limit. [EMFILE] 

Shmdt detaches from the calling process’s data segment the shared memory segment located at the address 
specified by shmaddr. 

Shmdt will fail and not detach the shared memory segment if shmaddr is not the data segment start address 
of a shared memory segment. [EINVAL] 

RETURN VALUES 

Upon successful completion, the return value is as follows: 
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Shmat returns the data segment start address of the attached shared memory segment. 
Shmdt returns a value of 0. 

Otherwise, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2), shmctl(2), shmget(2). 
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NAME 

signal - specify what to do upon receipt of a signal 
SYNOPSIS 

#include <sys/signal h> 

int ( signal (sig, func))() 

int sig; 

int (*func)(); 

DESCRIPTION 

Signal allows the calling process to choose one of three ways in which it is possible to handle the receipt of 
a specific signal. Sig specifies the signal and func specifies the choice. 

Sig can be assigned any one of the following except SIGKILL: 


SIGHUP01 

hangup 


SIGINT 

02 

interrupt 

SIGQUIT 

03* 

quit 

SIGILL 

04* 

illegal instruction (not reset when caught) 

SIGTRAP 

05* 

trace trap (not reset when caught) 

SIGIOT 

06* 

IOT instruction 

SIGEMT 

07* 

EMT instruction 

SIGFPE 

08* 

floating point exception 

SIGKILL 

09 

kill (cannot be caught or ignored) 

SIGBUS 10* 

bus error 

SIGSEGV 

11* 

segmentation violation 

SIGSYS 

12* 

bad argument to system call 

SIGPIPE 

13 

write on a pipe with no one to read it 

SIGALRM 

14 

alarm clock 

SIGTERM 

15 

software termination signal 

SIGUSR1 

16 

user defined signal 1 

SIGUSR2 

17 

user defined signal 2 

SIGCLD 18 

death of a child (see WARNING below) 

SIGPWR 

19 

power fail (see WARNING below) 


See below for the significance of the asterisk (*) in the above list. 

Func is assigned one of three values: SIG DFL, SIG IGN, or a function address. The actions prescribed by 
these values of are as follows: 

SIG DFL - terminate process upon receipt of a signal 

Upon receipt of the signal sig, the receiving process is to be terminated with all of the conse¬ 
quences outlined in exit(2) plus a “core image” will be made in the current working directory 
of the receiving process if sig is one for which an asterisk appears in the above list and the fol¬ 
lowing conditions are met: 

The effective user ID and the real user ID of the receiving process are equal. 

An ordinary file named core exists and is writable or can be created. If the file must 
be created, it will have the following properties: 

a mode of 0666 modified by the file creation mask (see umask( 2)) 

a file owner ID that is the same as the effective user ID of the receiving pro¬ 
cess 

a file group ID that is the same as the effective group ID of the receiving 
process 

SIG IGN - ignore signal 

The signal sig is to be ignored. 
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Note: the signal SIGKILL cannot be ignored. 
function address - catch signal 

Upon receipt of the signal sig, the receiving process is to execute the signal-catching function 
pointed to by func. The signal number sig will be passed as the only argument to the signal- 
catching function. Before entering the signal-catching function, the value of func for the caught 
signal will be set to SIG DFL unless the signal is SIGILL, SIGTRAP, or SIGPWR. 

Upon return from the signal-catching function, the receiving process will resume execution at the 
point it was interrupted. 

When a signal that is to be caught occurs during a read, a write, an open, or an ioctl system call 
on a slow device (like a terminal; but not a file), during a pause system call, or during a wait sys¬ 
tem call that does not return immediately due to the existence of a previously stopped or zombie 
process, the signal catching function will be executed and then the interrupted system call will 
return a -1 to the calling process with errno set to EINTR. 

Note: the signal SIGKILL cannot be caught. 

A call to signal cancels a pending signal sig except for a pending SIGKILL signal. 

Signal will fail if one or more of the following are true: 

Sig is an illegal signal number, including SIGKILL. [EINVAL] 

Func points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, signal returns the previous value of func for the specified signal sig. Other¬ 
wise, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

kill(l), kill(2), pause(2), ptrace(2), wait(2), setjmp(3C). 

WARNING 

Two other signals that behave differently than the signals described above exist in this release of the sys¬ 
tem; they are: 

SIGCLD 18 death of a child (reset when caught) 

SIGPWR 19 power fail (not reset when caught) 

There is no guarantee that, in future releases of the UNIX System, these signals will continue to behave as 
described below; they are included only for compatibility with other versions of the UNIX System. Their 
use in new programs is strongly discouraged. 

For these signals, func is assigned one of three values: SIG DFL, SIG IGN, or a function address. The 
actions prescribed by these values of are as follows: 

SIG DFL - ignore signal 

The signal is to be ignored. 

SIG IGN - ignore signal 

The signal is to be ignored. Also, if sig is SIGCLD, the calling process’s child processes will 
not create zombie processes when they terminate; see exit( 2). 

function address - catch signal 

If the signal is SIGPWR, the action to be taken is the same as that described above for func 
equal to function address. The same is true if the signal is SIGCLD except, that while the pro¬ 
cess is executing the signal-catching function any received SIGCLD signals will be queued and 
the signal-catching function will be continually reentered until the queue is empty. 

The SIGCLD affects two other system calls (waitd), and exit(2)) in the following ways: 

wait If the func value of SIGCLD is set to SIG IGN and a wait is executed, the wait will block until 
all of the calling process’s child processes terminate; it will then return a value of -1 with 
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errno set to ECHILD. 

exit If in the exiting process’s parent process th sfunc value of SIGCLD is set to SIG IGN, the exit¬ 
ing process will not create a zombie process. 

When processing a pipeline, the shell makes the last process in the pipeline the parent of the proceeding 
processes. A process that may be piped into in this manner (and thus become the parent of other pro¬ 
cesses) should take care not to set SIGCLD to be caught. 
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NAME 

stat, fstat - get file status 
SYNOPSIS 

#include <sys/types h> 

#include <sys/stat.h> 

int stat (path, buf) 
char *path; 
struct stat *buf; 

int fstat (hides, buf) 
int Hides; 
struct stat buf; 

DESCRIPTION 

Path points to a path name naming a file. Read, write or execute permission of the named file is not 
required, but all directories listed in the path name leading to the file must be searchable. Stat obtains 
information about the named file. 

Similarly, fstat obtains information about an open file known by the file descriptor/i/des, obtained from a 
successful open , creat, dup,fcntl, or pipe system call. 

Buf is a pointer to a stat structure into which information is placed concerning the file. 

The contents of the structure pointed to by buf include the following members: 


ushort 

st mode; 

/* File mode; see mknod( 2) */ 

ino t 

st ino; 

/* Inode number */ 

dev t 

st dev; 

/* ID of device containing */ 

/* a directory entry for this file */ 

dev t 

st rdev; 

/*■ ID of device */ 

/* This entry is defined only for */ 

/* character special or block special files */ 

short 

st nlink; 

/* Number of links */ 

ushort 

st uid; 

/*■ User ID of the file’s owner */ 

ushort 

stgid; 

/* Group ID of the file’s group *■/ 

off t 

st size; 

/* File size in bytes */ 

time t 

st atime; 

/* Time of last access */ 

time t 

st mtime; 

/* Time of last data modification */ 

time t 

st ctime; 

/* Time of last file status change *■/ 

/* Times measured in seconds since */ 

/* 00:00:00 GMT, Jan. 1, 1970 */ 


st atime Time when file data was last accessed. Changed by the following system calls: creat(2), 
mknod(2), pipe(2), utime( 2), and read( 2). 

st mtime Time when data was last modified. Changed by the following system calls: creat(2), 
mknod(2), pipe(2), utime(2), and write (2). 

st dime Time when file status was last changed. Changed by the following system calls: chmod{ 2), 
chown( 2), creat( 2), link( 2), mknod(2),pipe(2), unlink(2 ), utime(2), and write(2). 

Stat will fail if one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

The named file does not exist. [ENOENT] 

Search permission is denied for a component of the path prefix. [EACCES] 

Buf or path points to an invalid address. [EFAULT] 
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Fstat will fail if one or more of the following are true: 

Fildes is not a valid open file descriptor. [EBADF] 

Buf points to an invalid address. [EFAULT] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

chmod(2), chown(2), creat(2), link(2), mknod(2), time(2), unlink(2). 
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NAME 

stime - set time 

SYNOPSIS 

int stime (tp) 
long *tp; 

DESCRIPTION 

Stime sets the system’s idea of the time and date. Tp points to the value of time as measured in seconds 
from 00:00:00 GMT January 1, 1970. 

Stime will fail if the effective user ID of the calling process is not super-user. [EPERM] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

time(2). 
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NAME 

sync - update super-block 

SYNOPSIS 

void sync () 

DESCRIPTION 

Sync causes all information in memory that should be on disk to be written out. This includes modified 
super blocks, modified i-nodes, and delayed block I/O. 

It should be used by programs which examine a file system, for example fsck, df, etc. It is mandatory 
before a boot. 

The writing, although scheduled, is not necessarily complete upon return from sync. 
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NAME 

sys3b - 3B20S specific system calls 

SYNOPSIS 

void sys3b (cmd, argl[, arg2]) 

int cmd, argl, arg2; 

DESCRIPTION 

This system call provides for 3B20S specific actions. Most require super-user privileges as the effects can 

be dangerous. The cmd values available are: 

1 Reboot the processor. This call causes an immediate entry into the bootstrap code. 

2 System print/ interface. Argl is taken as a pointer to a null terminated string to be copied into the 
operating system circular print buffer. 

3 Attach to an address translation buffer. 

4 System namelist interface. The value of argl is used to return the address of various data elements in 
the system. 

5 Override for system Maintenance Reset Function (MRF) action. If argl is non-zero, it is taken as the 
indicator for handling a processor MRF. If zero, the current setting is returned. 

6 Send a Processor Recovery Message (PRM). Argl is used as a pointer to a 16 byte string to be con¬ 
verted to a PRM and transmitted to the Emergency Action Interface (EAI). 

7 Modify the System Status Register (SSR). Bits set in argl are set or cleared in the SSR if argl is 
non-zero or zero, respectively. 

8 Read EAI Input Parameter Buffer. Argl is used as a location in user space where the current Input 
Parameter Buffer is to be placed. 

9 Change default Field Test Set utility-id. 10 Change the floating point flag bits in the extended pro¬ 
cessor status word. 

SEE ALSO 

fts(lM), ipb(lM), prm(lM), reboot(lM), setmrf(lM), ssr(lM), in the UNIX System Administrator’s 

Manual. 
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NAME 

time - get time 

SYNOPSIS 

long time ((long *) 0) 

long time (tloc) 
long *tloc; 

DESCRIPTION 

Time returns the value of time in seconds since 00:00:00 GMT, January 1, 1970. 

If tloc (taken as an integer) is non-zero, the return value is also stored in the location to which tloc points. 
Time will fail if tloc points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, time returns the value of time. Otherwise, a value of -1 is returned and errno 
is set to indicate the error. 

SEE ALSO 

stime(2). 
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NAME 

times - get process and child process times 
SYNOPSIS 

#include <sys/types h> 

#include <sys/times h> 

long times (buffer) 
struct tms *buffer; 

DESCRIPTION 

Times fills the structure pointed to by buffer with time-accounting information. The following is this con¬ 
tents of the structure: 

struct tms { 

time_t tms_utime; 
time_t tms_stime; 
time_t tms_cutime; 
time_t tms_cstime; 

}; 

This information comes from the calling process and each of its terminated child processes for which it has 
executed a wait. All times are in 60ths of a second on DEC processors, lOOths of a second on WECo pro¬ 
cessors. 

Tmsutime is the CPU time used while executing instructions in the user space of the calling process. 
Tmsstime is the CPU time used by the system on behalf of the calling process. 

Tms cutime is the sum of the tmsjutimes and tms_cutime s of the child processes. 

Tms cstime is the sum of the tms_stime s and tms_cstimes of the child processes. 

Times will fail if buffer points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, times returns the elapsed real time, in 60ths (lOOths) of a second, since an 
arbitrary point in the past (e.g., system start-up time). This point does not change from one invocation of 
times to another. If times fails, a -1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), fork(2), time(2), wait(2). 
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NAME 

ulimit - get and set user limits 
SYNOPSIS 

long ulimit (cmd, newlimit) 
int cmd; 
long newlimit; 

DESCRIPTION 

This function provides for control over process limits. The cmd values available are: 

1 Get the process’s file size limit. The limit is in units of 512-byte blocks and is inherited by child pro¬ 
cesses. Files of any size can be read. 

2 Set the process’s file size limit to the value of newlimit. Any process may decrease this limit, but 
only a process with an effective user ID of super-user may increase the limit. Ulimit will fail and the 
limit will be unchanged if a process with an effective user ID other than super-user attempts to 
increase its file size limit. [EPERM] 

3 Get the maximum possible break value. See brk( 2). 

RETURN VALUE 

Upon successful completion, a non-negative value is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

SEE ALSO 

brk(2), write(2). 
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NAME 

umask - set and get file creation mask 

SYNOPSIS 

int umask (cmask) 
int cmask; 

DESCRIPTION 

Umask sets the process’s file mode creation mask to cmask and returns the previous value of the mask. 
Only the low-order 9 bits of cmask and the file mode creation mask are used. 

RETURN VALUE 

The previous value of the file mode creation mask is returned. 

SEE ALSO 

mkdir(l), sh(l), chmod(2), creat(2), mknod(2), open(2). 
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NAME 

umount - unmount a file system 

SYNOPSIS 

int umount (spec) 
char spec; 

DESCRIPTION 

Umount requests that a previously mounted file system contained on the block special device identified by 
spec be unmounted. Spec is a pointer to a path name. After unmounting the file system, the directory upon 
which the file system was mounted reverts to its ordinary interpretation. 

Umount may be invoked only by the super-user. 

Umount will fail if one or more of the following are true: 

The process’s effective user ID is not super-user. [EPERM] 

Spec does not exist. [ENXIO] 

Spec is not a block special device. [ENOTBLK] 

Spec is not mounted. [EINVAL] 

A file on spec is busy. [EBUSY] 

Spec points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

mount(2). 
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NAME 

uname - get name of current UNIX system 

SYNOPSIS 

#include <sys/utsname h> 

int uname (name) 
struct utsname *name; 

DESCRIPTION 

Uname stores information identifying the current UNIX system in the structure pointed to by name. 

Uname uses the structure defined in <sys/utsname.h> whose members are: 

char sysname[9]; 
char nodename[9]; 
char release[9]; 
char version[9]; 
char machine[9]; 

Uname returns a null-terminated character string naming the current UNIX system in the character array 
sysname. Similarly, nodename contains the name that the system is known by on a communications net¬ 
work. Release and version further identify the operating system. Machine contains a standard name that 
identifies the hardware that the UNIX System is running on. 

Uname will fail if name points to an invalid address. [EFAULT] 

RETURN VALUE 

Upon successful completion, a non-negative value is returned. Otherwise, -1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

uname(l). 
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NAME 

unlink - remove directory entry 

SYNOPSIS 

int unlink (path) 
char *path; 

DESCRIPTION 

Unlink removes the directory entry named by the path name pointed to be path. 

The named file is unlinked unless one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

The named file does not exist. [ENOENT] 

Search permission is denied for a component of the path prefix. [EACCES] 

Write permission is denied on the directory containing the link to be removed. [EACCES] 

The named file is a directory and the effective user ID of the process is not super-user. [EPERM] 

The entry to be unlinked is the mount point for a mounted file system. [EBUSY] 

The entry to be unlinked is the last link to a pure procedure (shared text) file that is being executed. 
[ETXTBSY] 

The directory entry to be unlinked is part of a read-only file system. [EROFS] 

Path points outside the process’s allocated address space. [EFAULT] 

When all links to a file have been removed and no process has the file open, the space occupied by the file 
is freed and the file ceases to exist. If one or more processes have the file open when the last link is 
removed, the removal is postponed until all references to the file have been closed. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

rm(l), close(2), link(2), open(2). 
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NAME 

ustat - get file system statistics 

SYNOPSIS 

#include <sys/types h> 

#include <ustat.h> 

int ustat (dev, buf) 
int dev; 

struct ustat buf; 

DESCRIPTION 

Ustat returns information about a mounted file system. Dev is a device number identifying a device con¬ 
taining a mounted file system. Buf is a pointer to a ustat structure that includes to following elements: 

dad dr t f tfree; /* Total free blocks */ 

ino_t f tinode; /* Number of free inodes */ 

char f_fname[6]; /* Filsys name */ 

char f fpack[6]; /* Filsys pack name */ 

Ustat will fail if one or more of the following are true: 

Dev is not the device number of a device containing a mounted file system. [EINVAL] 

Buf points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

stat(2), fs(4). 
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NAME 

utime - set file access and modification times 
SYNOPSIS 

#include <sys/types h> 
int utime (path, times) 
char *path; 
struct utimbuf Mimes; 

DESCRIPTION 

Path points to a path name naming a file. Utime sets the access and modification times of the named file. 

If times is NULL, the access and modification times of the file are set to the current time. A process must 
be the owner of the file or have write permission to use utime in this manner. 

If times is not NULL, times is interpreted as a pointer to a utimbuf structure and the access and modification 
times are set to the values contained in the designated structure. Only the owner of the file or the super-user 
may use utime this way. 

The times in the following structure are measured in seconds since 00:00:00 GMT, Jan. 1, 1970. 
struct utimbuf { 

time_t actime; /* access time */ 
time_t modtime; /* modification time */ 

}; 

Utime will fail if one or more of the following are true: 

The named file does not exist. [ENOENT] 

A component of the path prefix is not a directory. [ENOTDIR] 

Search permission is denied by a component of the path prefix. [EACCES] 

The effective user ID is not super-user and not the owner of the file and times is not NULL. 
[EPERM] 

The effective user ID is not super-user and not the owner of the file and times is NULL and write 
access is denied. [EACCES] 

The file system containing the file is mounted read-only. [EROFS] 

Times is not NULL and points outside the process’s allocated address space. [EFAULT] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

stat(2). 
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NAME 

wait - wait for child process to stop or terminate 

SYNOPSIS 

int wait (stat loc) 
int *stat loc; 

int wait ((int *)0) 

DESCRIPTION 

Wait suspends the calling process until it receives a signal that is to be caught (see signal( 2)), or until any 
one of the calling process’s child processes stops in a trace mode (see ptrace( 2)) or terminates. If a child 
process stopped or terminated prior to the call on wait , return is immediate. 

If stat Joe (taken as an integer) is non-zero, 16 bits of information called status are stored in the low order 
16 bits of the location pointed to by stat Joe. Status can be used to differentiate between stopped and ter¬ 
minated child processes and if the child process terminated, status identifies the cause of termination and 
pass useful information to the parent. This is accomplished in the following manner: 

If the child process stopped, the high order 8 bits of status will contain the number of the signal 
that caused the process to stop and the low order 8 bits will be set equal to 0177. 

If the child process terminated due to an exit call, the low order 8 bits of status will be zero and the 
high order 8 bits will contain the low order 8 bits of the argument that the child process passed to 
exit ; see exit( 2). 

If the child process terminated due to a signal, the high order 8 bits of status will be zero and the 
low order 8 bits will contain the number of the signal that caused the termination. In addition, if 
the low order seventh bit (i.e., bit 200) is set, a “core image” will have been produced; see 
signal ( 2). 

If a parent process terminates without waiting for its child processes to terminate, the parent process ID of 
each child process is set to 1. This means the initialization process inherits the child processes; see intro{ 2). 

Wait will fail and return immediately if one or more of the following are true; 

The calling process has no existing unwaited-for child processes. [ECHILD] 

Stat Joe points to an illegal address. [EFAULT] 

RETURN VALUE 

If wait returns due to the receipt of a signal, a value of -1 is returned to the calling process and errno is set 
to EINTR. If wait returns due to a stopped or terminated child process, the process ID of the child is 
returned to the calling process. Otherwise, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2), pause(2), signal(2). 

WARNING 

See WARNING in signal( 2). 


Page 1 



WRITE (2) 


WRITE (2) 


NAME 

write - write on a file 
SYNOPSIS 

int write (Aides, buf, nbyte) 
int Aides; 
char *buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a Ale descriptor obtained from a creat, open, dup.fcntl, or pipe system call. 

Write attempts to write nbyte bytes from the buffer pointed to by buf to the Ale associated with the, fildes. 

On devices capable of seeking, the actual writing of data proceeds from the position in the Ale indicated by 
the Ale pointer. Upon return from write, the Ale pointer is incremented by the number of bytes actually 
written. 

On devices incapable of seeking, writing always takes place starting at the current position. The value of a 
Ale pointer associated with such a device is undeAned. 

If the O APPEND Aag of the Ale status Aags is set, the Ale pointer will be set to the end of the Ale prior to 
each write. 

Write will fail and the Ale pointer will remain unchanged if one or more of the following are true: 

Fildes is not a valid Ale descriptor open for writing. [EBADF] 

An attempt is made to write to a pipe that is not open for reading by any process. [EPIPE and SIG- 
PIPE signal] 

An attempt was made to write a Ale that exceeds the process’s Ale size limit or the maximum Ale 
size. See ulimit (2). [EFBIG] 

Buf points outside the process’s allocated address space. [EFAULT] 

If a write requests that more bytes be written than there is room for (e.g., the ulimit (see ulimit(2)) or the 
physical end of a medium), only as many bytes as there is room for will be written. For example, suppose 
there is space for 20 bytes more in a Ale before reaching a limit. A write of 512 bytes will return 20. The 
next write of a non-zero number of bytes will give a failure return (except as noted below). 

If the Ale being written is a pipe (or FIFO), no partial writes will be permitted. Thus, the write will fail if a 
write of nbyte bytes would exceed a limit. 

If the Ale being written is a pipe (or FIFO) and the O NDELAY Aag of the Ale Aag word is set, then write to 
a full pipe (or FIFO) will return a count of 0. Otherwise (O NDELAY clear), writes to a full pipe (or FIFO) 
will block until space becomes available. 

RETURN VALUE 

Upon successful completion the number of bytes actually written is returned. Otherwise, -1 is returned and 
errno is set to indicate the error. 

SEE ALSO 

creat(2), dup(2), lseek(2), open(2), pipe(2), ulimit(2). 
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NAME 

intro - introduction to subroutines and libraries 

SYNOPSIS 

#include <stdio h> 

#include <math.h> 

DESCRIPTION 

This section describes functions found in various libraries, other than those functions that directly invoke 
UNIX system primitives, which are described in Section 2 of this volume. Certain major collections are 
identified by a letter after the section number: 

(3C) These functions, together with those of Section 2 and those marked (3S), constitute the Standard C 
Library libc , which is automatically loaded by the C compiler, cc(l). The link editor ld{ 1) searches 
this library under the -lc option. Declarations for some of these functions may be obtained from 
#include files indicated on the appropriate pages. 

(3F) These functions constitute the FORTRAN intrinsic function library, libF77. These functions are 
automatically available to the FORTRAN programmer and require no special invocation of the com¬ 
piler. 

(3M) These functions constitute the Math Library, libm. They are automatically loaded as needed by the 
FORTRAN compiler/77(1). They are not automatically loaded by the C compiler, cc(l); however, 
the link editor searches this library under the -lm option. Declarations for these functions may be 
obtained from the #include file <math.h>. 

(3S) These functions constitute the “standard I/O package” (see stdio{ 3S)). These functions are in the 
library libc, already mentioned. Declarations for these functions may be obtained from the 

#include file <stdio.h>. 

(3X) Various specialized libraries. The files in which these libraries are found are given on the appropri¬ 
ate pages. 

DEFINITIONS 

A character is any bit pattern able to fit into a byte on the machine. The null character is a character with 
value 0, represented in the C language as ’\0\ A character array is a sequence of characters. A null- 
terminated character array is a sequence of characters, the last of which is the null character. A string is a 
designation for a null-terminated character array. The null string is a character array containing only the 
null character. A NULL pointer is the value that is obtained by casting 0 into a pointer. The C language 
guarantees that this value will not match that of any legitimate pointer, so many functions that return point¬ 
ers return it to indicate an error. NULL is defined as 0 in <stdio.h>; the user can include his own definition 
if he is not using <stdio.h>. 

Many groups of FORTRAN intrinsic functions have generic function names that do not require explicit or 
implicit type declaration. The type of the function will be determined by the type of its argument(s). For 
example, the generic function max will return an integer value if given integer arguments ( maxO ), a real 
value if given real arguments ( amaxl ), or a double-precision value if given double-precision arguments 
( dmaxl ). 

FILES 

/lib/libc.a 

/usr/lib/libF77.a 

/lib/libm.a 

SEE ALSO 

ar(l), cc( 1), f77(l), ld(l), nm(l), intro(2), stdio(3S). 

DIAGNOSTICS 

Functions in the Math Library (3M) may return the conventional values 0 or HUGE (the largest single¬ 
precision floating-point number) when the function is undefined for the given arguments or when the value 
is not representable. In these cases, the external variable errno (see intro{ 2)) is set to the value EDOM or 
ERANGE. As many of the FORTRAN intrinsic functions use the routines found in the Math Library, the 
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NAME 

a641,164a - convert between long integer and base-64 ASCII string 

SYNOPSIS 

long a641 (s) 
char *s; 

char *164a (1) 
long 1; 

DESCRIPTION 

These functions are used to maintain numbers stored in base-64 ASCII characters. This is a notation by 
which long integers can be represented by up to six characters; each character represents a “digit” in a 
radix-64 notation. 

The characters used to represent “digits” are . for 0, / for 1, 0 through 9 for 2-11, A through Z for 12-37, 
and a through z for 38-63. 

A641 takes a pointer to a null-terminated base-64 representation and returns a corresponding long value. If 
the string pointed to by s contains more than six characters, a64l will use the first six. 

L64a takes a long argument and returns a pointer to the corresponding base-64 representation. If the argu¬ 
ment is 0, 164a returns a pointer to a null string. 

BUGS 

The value returned by 164a is a pointer into a static buffer, the contents of which are overwritten by each 
call. 


Page 1 



ABORT(3C) 


ABORT(3C) 


NAME 

abort - generate an IOT fault 

SYNOPSIS 

int abort () 

DESCRIPTION 

Abort causes an IOT signal to be sent to the process. This usually results in termination with a core dump. 

It is possible for abort to return control if SIGIOT is caught or ignored, in which case the value returned is 
that of the kill(2) system call. 

SEE ALSO 

adb(l), exit(2), kill(2), signal(2). 

DIAGNOSTICS 

If SIGIOT is neither caught nor ignored, and the current directory is writable, a core dump is produced and 
the message “abort - core dumped" is written by the shell. 
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NAME 

abort - terminate Fortran program 

SYNOPSIS 

call abort () 

DESCRIPTION 

Abort terminates the program which calls it, closing all open files truncated to the current position of the 
file pointer. 

DIAGNOSTICS 

When invoked, abort prints “Fortran abort routine called” on the standard error output. 

SEE ALSO 

abort(3C). 
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NAME 

abs - return integer absolute value 

SYNOPSIS 

int abs (i) 
int i; 

DESCRIPTION 

Abs returns the absolute value of its integer operand. 

BUGS 

In two’s-complement representation, the absolute value of the negative integer with largest magnitude is 
undefined. Some implementations trap this error, but others simply ignore it. 

SEE ALSO 

floor(3M). 
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NAME 

abs, iabs, dabs, cabs, zabs - Fortran absolute value 

SYNOPSIS 

integer il, i2 
real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 
double complex dxl, dx2 

r2 = abs(rl) 

i2 = iabs(il) 
i2 = abs(il) 

dp2 = dabs(dpl) 
dp2 = abs(dpl) 

cx2 = cabs(cxl) 
cx2 = abs(cxl) 

dx2 = zabs(dxl) 
dx2 = abs(dxl) 

DESCRIPTION 

Abs is the family of absolute value functions. labs returns the integer absolute value of its integer argu¬ 
ment. Dabs returns the double-precision absolute value of its double-precision argument. Cabs returns the 
complex absolute value of its complex argument. Zabs returns the double-complex absolute value of its 
double-complex argument. The generic form abs returns the type of its argument. 

SEE ALSO 

floor(3M). 
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NAME 

acos, dacos - Fortran arccosine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = acos(rl) 

dp2 = dacos(dpl) 
dp2 = acos(dpl) 

DESCRIPTION 

Acos returns the real arccosine of its real argument. Dacos returns the double-precision arccosine of its 
double-precision argument. The generic form acos may be used with impunity as its argument will deter¬ 
mine the type of the returned value. 

SEE ALSO 

trig(3M). 
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NAME 

aimag, dimag - Fortran imaginary part of complex argument 

SYNOPSIS 

real r 

complex cxr 
double precision dp 
double complex cxd 

r = aimag(cxr) 

dp = dimag(cxd) 

DESCRIPTION 

Aimag returns the imaginary part of its single-precision complex argument. Dimag returns the double¬ 
precision imaginary part of its double-complex argument. 
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NAME 

aint, dint - Fortran integer part intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = aint(rl) 

dp2 = dint(dpl) 
dp2 = aint(dpl) 

DESCRIPTION 

Aint returns the truncated value of its real argument in a real. Dint returns the truncated value of its 
double-precision argument as a double-precision value. Aint may be used as a generic function name, 
returning either a real or double-precision value depending on the type of its argument. 
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NAME 

asin, dasin - Fortran arcsine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = asin(rl) 

dp2 = dasin(dpl) 
dp2 = asin(dpl) 

DESCRIPTION 

Asin returns the real arcsine of its real argument. Dasin returns the double-precision arcsine of its double¬ 
precision argument. The generic form asin may be used with impunity as it derives its type from that of its 
argument. 

SEE ALSO 

trig(3M). 
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NAME 

assert - verify program assertion 

SYNOPSIS 

#include <assert.h> 

assert (expression) 
int expression; 

DESCRIPTION 

This macro is useful for putting diagnostics into programs. When it is executed, if expression is false 
(zero), assert prints 

“Assertion failed: expression , file xyz, line nnn” 

on the standard error output and aborts. In the error message, xyz is the name of the source file and nnn the 
source line number of the assert statement. 

Compiling with the preprocessor option -DNDEBUG (see cpp ( I)), or with the preprocessor control state¬ 
ment “#define NDEBUG” ahead of the “#include <assert.h>” statement, will stop assertions from being 
compiled into the program. 

SEE ALSO 

cpp(l), abort(3C). 
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NAME 

atan, datan - Fortran arctangent intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = atan(rl) 

dp2 = datan(dpl) 
dp2 = atan(dpl) 

DESCRIPTION 

Atan returns the real arctangent of its real argument. Datan returns the double-precision arctangent of its 
double-precision argument. The generic form atan may be used with a double-precision argument return¬ 
ing a double-precision value. 

SEE ALSO 

trig(3M). 
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NAME 

atan2, datan2 - Fortran arctangent intrinsic function 

SYNOPSIS 

real rl, r2, r3 

double precision dpi, dp2, dp3 

r3 = atan2(rl, r2) 

dp3 = datan2(dpl, dp2) 
dp3 = atan2(dpl, dp2) 

DESCRIPTION 

Atan2 returns the arctangent of argl/arg2 as a real value. Datan2 returns the double-precision arctangent 
of its double-precision arguments. The generic form atan2 may be used with impunity with double¬ 
precision arguments. 

SEE ALSO 

trig(3M). 
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NAME 

atof - convert ASCII string to floating-point number 

SYNOPSIS 

double atof (nptr) 
char nptr; 

DESCRIPTION 

Atof converts a character string pointed to by nptr to a double-precision floating-point number. The first 
unrecognized character ends the conversion. Atof recognizes an optional string of white-space characters, 
then an optional sign, then a string of digits optionally containing a decimal point, then an optional e or E 
followed by an optionally signed integer. If the string begins with an unrecognized character, atof returns 
the value zero. 

DIAGNOSTICS 

When the correct value would overflow, atof returns HUGE, and sets errno to ERANGE. Zero is returned 
on underflow. 

SEE ALSO 

scanf(3S). 
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NAME 

jO, jl, jn, yO, yl, yn - Bessel functions 

SYNOPSIS 

#include <math.h> 

double jO (x) 
double x; 

double jl (x) 
double x; 

double jn (n, x) 
int n; 
double x; 

double yO (x) 
double x; 

double yl (x) 
double x; 

double yn (n, x) 
int n; 
double x; 

DESCRIPTION 

JO and jl return Bessel functions of x of the first kind of orders 0 and 1 respectively. Jn returns the Bessel 
function of x of the first kind of order n. 

YO and yl return the Bessel functions of x of the second kind of orders 0 and 1 respectively. Yn returns the 
Bessel function of x of the second kind of order n. The value of x must be positive. 

DIAGNOSTICS 

Non-positive arguments cause yO, yl and yn to return the value HUGE and to set errno to EDOM. They 
also cause a message indicating DOMAIN error to be printed on the standard error output; the process will 
continue. 

These error-handling procedures may be changed with the function matherr( 3M). 

SEE ALSO 

matherr(3M). 
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NAME 

and, or, xor, not, lshift, rshift - Fortran bitwise boolean functions 

SYNOPSIS 

integer i, j, k 
real a, b, c 

double precision dpi, dp2, dp3 

k = and(i, j) 
c = or(a, b) 
j = xor(i, a) 
j = not(i) 
k = lshiftfi, j) 
k = rshift(i, j) 

DESCRIPTION 

The generic intrinsic boolean functions and, or and xor return the value of the binary operations on their 
arguments. Not is a unary operator returning the one’s complement of its argument. Lshift and rshift 
return the value of the first argument shifted left or right, respectively, the number of times specified by the 
second (integer) argument. 

The boolean functions are generic, that is, they are defined for all data types as arguments and return values. 
Where required, the compiler will generate appropriate type conversions. 

NOTE 

Although defined for all data types, use of boolean functions on any but integer data is bizarre and will 
probably result in unexpected consequences. 

BUGS 

The implementation of the shift functions may cause large shift values to deliver weird results. 
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NAME 

bsearch - binary search 

SYNOPSIS 

char *bsearch ((char *) key, (char *) base, nel, sizeof (*key), compar) 
unsigned nel; 
int (*compar)(); 

DESCRIPTION 

Bsearch is a binary search routine generalized from Knuth (6.2.1) Algorithm B. It returns a pointer into a 
table indicating where a datum may be found. The table must be previously sorted in increasing order 
according to a provided comparison function. Key points to the datum to be sought in the table. Base 
points to the element at the base of the table. Nel is the number of elements in the table. Compar is the 
name of the comparison function, which is called with two arguments that point to the elements being com¬ 
pared. The function must return an integer less than, equal to, or greater than zero according as the first 
argument is to be considered less than, equal to, or greater than the second. 

DIAGNOSTICS 

A NULL pointer is returned if the key cannot be found in the table. 

NOTES 

The pointers to the key and the element at the base of the table should be of type pointer-to-element, and 
cast to type pointer-to-character. 

The comparison function need not compare every byte, so arbitrary data may be contained in the elements 
in addition to the values being compared. 

Although declared as type pointer-to-character, the value returned should be cast into type pointer-to- 
element. 

SEE ALSO 

lsearch(3C), hsearch(3C), qsort(3C), tsearch(3C). 
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NAME 

clock - report CPU time used 

SYNOPSIS 

long clock () 

DESCRIPTION 

Clock returns the amount of CPU time (in microseconds) used since the first call to clock. The time 
reported is the sum of the user and system times of the calling process and its terminated child processes for 
which it has executed wait( 2) or system{ 3S). 

The resolution of the clock is 10 milliseconds on Western Electric 3B processors, 16.667 milliseconds on 
Digital Equipment Corporation processors. 

SEE ALSO 

times(2), wait(2), system(3S). 

BUGS 

The value returned by clock is defined in microseconds for compatibility with systems that have CPU 
clocks with much higher resolution. Because of this, the value returned will wrap around after accumulat¬ 
ing only 2147 seconds of CPU time (about 36 minutes). 


Page 1 



CONJG(3F) 


CONJG(3F) 


NAME 

conjg, dconjg - Fortran complex conjugate intrinsic function 

SYNOPSIS 

complex cxl, cx2 
double complex dxl, dx2 

cx2 = conjg(cxl) 

dx2 = dconjg(dxl) 

DESCRIPTION 

Conjg returns the complex conjugate of its complex argument. Dconjg returns the double-complex conju¬ 
gate of its double-complex argument. 
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NAME 

toupper, tolower, toupper, tolower, toascii - translate characters 

SYNOPSIS 

#include <ctype h> 

int toupper (c) 
int c; 

int tolower (c) 
int c; 

int toupper (c) 
int c; 

int tolower (c) 
int c; 

int toascii (c) 
int c; 

DESCRIPTION 

Toupper and tolower have as domain the range of getc(3S): the integers from -1 through 255. If the argu¬ 
ment of toupper represents a lower-case letter, the result is the corresponding upper-case letter. If the argu¬ 
ment of tolower represents an upper-case letter, the result is the corresponding lower-case letter. All other 
arguments in the domain are returned unchanged. 

Joupper and tolower are macros that accomplish the same thing as toupper and tolower but have 
restricted domains and are faster. Joupper requires a lower-case letter as its argument; its result is the cor¬ 
responding upper-case letter, tolower requires an upper-case letter as its argument; its result is the corre¬ 
sponding lower-case letter. Arguments outside the domain cause undefined results. 

Toascii yields its argument with all bits turned off that are not part of a standard ASCII character; it is 
intended for compatibility with other systems. 

SEE ALSO 

ctype(3C), getc(3S). 
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NAME 

cos, dcos, ccos - Fortran cosine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = cos(rl) 

dp2 = dcos(dpl) 
dp2 = cos(dpl) 

cx2 = ccos(cxl) 
cx2 = cos(cxl) 

DESCRIPTION 

Cos returns the real cosine of its real argument. Dcos returns the double-precision cosine of its double¬ 
precision argument. Ccos returns the complex cosine of its complex argument. The generic form cos may 
be used with impunity as its returned type is determined by that of its argument. 

SEE ALSO 

trig(3M). 
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NAME 

cosh, dcosh - Fortran hyperbolic cosine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = cosh(rl) 

dp2 = dcosh(dpl) 
dp2 = cosh(dpl) 

DESCRIPTION 

Cosh returns the real hyperbolic cosine of its real argument. Dcosh returns the double-precision hyperbolic 
cosine of its double-precision argument. The generic form cosh may be used to return the hyperbolic 
cosine in the type of its argument. 

SEE ALSO 

sinh(3M). 
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NAME 

crypt, setkey, encrypt - generate DES encryption 
SYNOPSIS 

char crypt (key, salt) 
char *key, salt; 

void setkey (key) 
char *key; 

void encrypt (block, edflag) 
char *block; 
int edflag; 

DESCRIPTION 

Crypt is the password encryption function. It is based on the NBS Data Encryption Standard (DES), with 
variations intended (among other things) to frustrate use of hardware implementations of the DES for key 
search. 

Key is a user’s typed password. Salt is a two-character string chosen from the set [a-zA-ZO-9./]; this string 
is used to perturb the DES algorithm in one of 4096 different ways, after which the password is used as the 
key to encrypt repeatedly a constant string. The returned value points to the encrypted password. The first 
two characters are the salt itself. 

The setkey and encrypt entries provide (rather primitive) access to the actual DES algorithm. The argument 
of setkey is a character array of length 64 containing only the characters with numerical value 0 and 1. If 
this string is divided into groups of 8, the low-order bit in each group is ignored; this gives a 56-bit key 
which is set into the machine. This is the key that will be used with the above mentioned algorithm to 
encrypt or decrypt the string block with the function encrypt. 

The argument to the encrypt entry is a character array of length 64 containing only the characters with 
numerical value 0 and 1. The argument array is modified in place to a similar array representing the bits of 
the argument after having been subjected to the DES algorithm using the key set by setkey. If edflag is 
zero, the argument is encrypted; if non-zero, it is decrypted. 

SEE ALSO 

login) 1), passwd(l), getpass(3C), passwd(4). 

BUGS 

The return value points to static data that are overwritten by each call. 
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NAME 

ctermid - generate file name for terminal 

SYNOPSIS 

#include <stdio h> 

char *ctermid(s) 
char *s; 

DESCRIPTION 

Ctermid generates the path name of the controlling terminal for the current process, and stores it in a string. 

If s is a NULL pointer, the string is stored in an internal static area, the contents of which are overwritten at 
the next call to ctermid, and the address of which is returned. Otherwise, s is assumed to point to a charac¬ 
ter array of at least L ctermid elements; the path name is placed in this array and the value of ,v is returned. 
The constant L ctermid is defined in the <stdio.h> header file. 

NOTES 

The difference between ctermid and ttyname( 3C) is that ttyname must be handed a file descriptor and 
returns the actual name of the terminal associated with that file descriptor, while ctermid returns a string 
(/dev/tty) that will refer to the terminal if used as a file name. Thus ttyname is useful only if the process 
already has at least one file open to a terminal. 

SEE ALSO 

ttyname(3C). 
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NAME 

ctime, localtime, gmtime, asctime, tzset - convert date and time to string 

SYNOPSIS 

#include <time.h> 

char * ctime (clock) 
long *clock; 

struct tm *localtime (clock) 
long *clock; 

struct tm * gmtime (clock) 
long *clock; 

char asctime (tm) 
struct tm *tm; 

extern long timezone; 

extern int daylight; 

extern char *tzname[2]; 

void tzset () 

DESCRIPTION 

Ctime converts a long integer, pointed to by clock , representing the time in seconds since 00:00:00 GMT, 
January 1, 1970, and returns a pointer to a 26-character string in the following form. All the fields have 
constant width. 

Sun Sep 16 01:03:52 1973\n\0 

Localtime and gmtime return pointers to “tm” structures, described below. Localtime corrects for the time 
zone and possible Daylight Savings Time; gmtime converts directly to Greenwich Mean Time (GMT), 
which is the time the UNIX System uses. 

Asctime converts a ‘ ‘tm’ ’ structure to a 26-character string, as shown in the above example, and returns a 
pointer to the string. 

Declarations of all the functions and externals, and the “tm” structure, are in the <time.h> header file. The 
structure declaration is: 

struct tm { 

int tm_sec; /* seconds (0 - 59) */ 

int tmrnin; /* minutes (0 - 59) */ 

int tmhour; /* hours (0 - 23) */ 

int tm_mday; /*■ day of month (1 - 31) */ 

int tm_mon; /* month of year (0 - 11) */ 

int tm_year; /* year - 1900 */ 

int tmwday; /*■ day of week (Sunday = 0) */ 

int tm_yday; /* day of year (0 - 365) */ 

int tm_isdst; 

}; 

Tmjsdst is non-zero if Daylight Savings Time is in effect. 

The external long variable timezone contains the difference, in seconds, between GMT and local standard 
time (in EST, timezone is 5*60*60); the external variable daylight is non-zero if and only if the standard 
U.S.A. Daylight Savings Time conversion should be applied. The program knows about the peculiarities of 
this conversion in 1974 and 1975; if necessary, a table for these years can be extended. 

If an environment variable named TZ is present, asctime uses the contents of the variable to override the 
default time zone. The value of TZ must be a three-letter time zone name, followed by a number 
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representing the difference between local time and Greenwich Mean Time in hours, followed by an optional 
three-letter name for a daylight time zone. For example, the setting for New Jersey would be EST5EDT. 
The effects of setting TZ are thus to change the values of the external variables timezone and daylight ; in 
addition, the time zone names contained in the external variable 

char *tzname[2] = { "EST", "EDT" }; 

are set from the environment variable TZ. The function tzset sets these external variables from TZ; tzset is 
called by asctime and may also be called explicitly by the user. 

Note that in most installations, TZ is set by default when the user logs on, to a value in the local /etc/profile 
file (see profile(A)). 

SEE ALSO 

time(2), getenv(3C), profile(4), environ(5). 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, isgraph, iscntrl, isascii - clas¬ 
sify characters 

SYNOPSIS 

#include <ctype h> 

int isalpha (c) 
int c; 

DESCRIPTION 

These macros classify character-coded integer values by table lookup. Each is a predicate returning 
nonzero for true, zero for false. Isascii is defined on all integer values; the rest are defined only where 
isascii is true and on the single non-ASCII value EOF (-1 - see stdio{ 3S)). 


isalpha 

c is a letter. 

isupper 

c is an upper-case letter. 

islower 

c is a lower-case letter. 

isdigit 

c is a digit [0-9], 

isxdigit 

c is a hexadecimal digit [0-9], [A-F] or [a-f]. 

isalnum 

c is an alphanumeric (letter or digit). 

isspace 

c is a space, tab, carriage return, new-line, vertical tab, or form-feed. 

ispunct 

c is a punctuation character (neither control nor alphanumeric). 

isprint 

c is a printing character, code 040 (space) through 0176 (tilde). 

isgraph 

c is a printing character, like isprint except false for space. 

iscntrl 

c is a delete character (0177) or an ordinary control character (less than 040). 

isascii 

c is an ASCII character, code less than 0200. 

DIAGNOSTICS 



If the argument to any of these macros is not in the domain of the function, the result is undefined. 

SEE ALSO 

ascii(5). 
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NAME 

cuserid - get character login name of the user 

SYNOPSIS 

#include <stdio h> 

char cuserid (s) 
char *s; 

DESCRIPTION 

Cuserid generates a character-string representation of the login name of the owner of the current process. If 
s is a NULL pointer, this representation is generated in an internal static area, the address of which is 
returned. Otherwise, s is assumed to point to an array of at least L cuserid characters; the representation is 
left in this array. The constant L cuserid is defined in the <stdio.h> header file. 

DIAGNOSTICS 

If the login name cannot be found, cuserid returns a NULL pointer; if s is not a NULL pointer, a null charac¬ 
ter (\0) will be placed at s[0], 

SEE ALSO 

getlogin(3C), getpwent(3C). 
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NAME 

dial - establish an out-going terminal line connection 

SYNOPSIS 

#include <dial.h> 

int dial (call) 

CALL call; 

void undial (fd) 
int fd; 

DESCRIPTION 

Dial returns a file-descriptor for a terminal line open for read/write. The argument to dial is a CALL struc¬ 
ture (defined in the <dial.h> header file. 

When finished with the terminal line, the calling program must invoke undial to release the semaphore that 
has been set during the allocation of the terminal device. 

The CALL typedef in the <dial.h> header file is: 

typedef struct { 


struct termio *attr; 

/* pointer to termio attribute struct */ 

int 

baud; 

/* transmission data rate */ 

int 

speed; 

/* 212A modem: low=300, high=1200 */ 

char 

*line; 

/* device name for out-going line */ 

char 

*telno; 

/* pointer to tel-no digits string */ 

int 

modem; 

/* specify modem control for direct lines */ 


} CALL; 

The CALL element speed is intended only for use with an outgoing dialed call, in which case its value 
should be either 300 or 1200 to identify the 113A modem, or the high or low speed setting on the 212A 
modem. The CALL element baud is for the desired transmission baud rate. For example, one might set 
baud to 110 and speed to 300 (or 1200). 

If the desired terminal line is a direct line, a string pointer to its device-name should be placed in the line 
element in the CALL structure. Legal values for such terminal device names are kept in the L-devices file. 
In this case, the value of the baud element need not be specified as it will be determined from the L-devices 
file. 

The telno element is for a pointer to a character string representing the telephone number to be dialed. 
Such numbers may consist only of symbols described on the acu(l). The termination symbol will be sup¬ 
plied by the dial function, and should not be included in the telno string passed to dial in the CALL struc¬ 
ture. 

The CALL element modem is used to specify modem control for direct lines. This element should be non¬ 
zero if modem control is required. The CALL element attr is a pointer to a termio structure, as defined in 
the termio.h header file. A NULL value for this pointer element may be passed to the dial function, but if 
such a structure is included, the elements specified in it will be set for the outgoing terminal line before the 
connection is established. This is often important for certain attributes such as parity and baud-rate. 

PILES 

/usr/lib/uucp/L-devices 
/usr/spool/uucp/LCK. .tty-device 

SEE ALSO 

uucp(lC), alarm(2), read(2), write(2). 

acu(7), termio(7) in the UNIX System Administrator’s Manual. 

DIAGNOSTICS 

On failure, a negative value indicating the reason for the failure will be returned. Mnemonics for these neg¬ 
ative indices as listed here are defined in the <dial.h> header file. 
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INTRPT 

-1 

/* interrupt occured */ 

D HUNG 

-2 

/* dialer hung (no return from write) */ 

NO 

ANS 

-3 

/*■ no answer within 10 seconds */ 

ILL 

BD 

-4 

/* illegal baud-rate */ 

APROB 

-5 

/* acu problem (open() failure) */ 

LPROB 

-6 

/* line problem (open() failure) */ 

NO Ldv 

-7 

/* can’t open LDEVS file */ 

DV 

NT_A 

-8 

/* requested device not available */ 

DV 

NT_K 

-9 

/* requested device not known */ 

NO 

BD_A 

-10 

/* no device available at requested baud */ 

NO 

BD_K 

-11 

/*■ no device known at requested baud */ 


WARNINGS 

Including the <dial.h> header file automatically includes the <termio h> header file. 

The above routine uses <stdio h>, which causes it to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 

BUGS 

An alarm ( 2) system call for 3600 seconds is made (and caught) within the dial module for the purpose of 
“touching” the LCK.. file and constitutes the device allocation semaphore for the terminal device. Other¬ 
wise, uucp( IC) may simply delete the LCK.. entry on its 90-minute clean-up rounds. The alarm may go off 
while the user program is in a read (2) or write (2) system call, causing an apparent error return. If the user 
program expects to be around for an hour or more, error returns from reads should be checked for 
(errno==EINTR), and the read possibly reissued. 
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NAME 

drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, lcong48 - generate uniformly dis¬ 
tributed pseudo-random numbers 

SYNOPSIS 

double drand48 () 

double erand48 (xsubi) 
unsigned short xsubi[3]; 

long lrand48 () 

long nrand48 (xsubi) 
unsigned short xsubi[3]; 

long mrand48 () 

long jrand48 (xsubi) 
unsigned short xsubi[3]; 

void srand48 (seedval) 
long seedval; 

unsigned short *seed48 (seedl6v) 
unsigned short seedl6v[3]; 

void lcong48 (param) 
unsigned short param[7]; 

DESCRIPTION 

This family of functions generates pseudo-random numbers using the well-known linear congruential algo¬ 
rithm and 48-bit integer arithmetic. 

Functions drand48 and erand48 return non-negative double-precision floating-point values uniformly dis¬ 
tributed over the interval [0.0, 1.0). 

Functions lrand48 and nrand48 return non-negative long integers uniformly distributed over the interval 

[ 0 , 2 31 ). 

Functions mrand48 and jrand48 return signed long integers uniformly distributed over the interval 

[ — 2 31 , 2 31 ). 

Functions srand48, seed48 and lcong48 are initialization entry points, one of which should be invoked 
before either drand48, lrand48 or mrand48 is called. (Although it is not recommended practice, constant 
default initializer values will be supplied automatically if drand48, lrand48 or mrand48 is called without a 
prior call to an initialization entry point.) Functions ercmd48, nrand48 and jrand48 do not require an ini¬ 
tialization entry point to be called first. 

All the routines work by generating a sequence of 48-bit integer values. A,-, according to the linear congru¬ 
ential formula 

A n + 1 (uA H + c) mo d m n — 0. 

The parameter m = 2 48 ; hence 48-bit integer arithmetic is performed. Unless lcong48 has been invoked, 
the multiplier value a and the addend value c are given by 

a = 5DEECE66D 16 = 273673163155 8 
c = B 16 = 13 g. 

The value returned by any of the functions drand48, erand48, lrand48, nrand48, mrand48 or jrand48 is 
computed by first generating the next 48-bit A,- in the sequence. Then the appropriate number of bits, 
according to the type of data item to be returned, are copied from the high-order (leftmost) bits of A, and 
transformed into the returned value. 
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The functions drand48, lrand48 and mrand48 store the last 48-bit X, generated in an internal buffer; that is 
why they must be initialized prior to being invoked. The functions erand48, nrand48 and jrand48 require 
the calling program to provide storage for the successive X t values in the array specified as an argument 
when the functions are invoked. That is why these routines do not have to be initialized; the calling pro¬ 
gram merely has to place the desired initial value of X ,■ into the array and pass it as an argument. By using 
different arguments, functions erand48, nrand48 and jrand48 allow separate modules of a large program to 
generate several independent streams of pseudo-random numbers, i.e., the sequence of numbers in each 
stream will not depend upon how many times the routines have been called to generate numbers for the 
other streams. 

The initializer function srand48 sets the high-order 32 bits of X, to the 32 bits contained in its argument. 
The low-order 16 bits of X t are set to the arbitrary value 330E 16 . 

The initializer function seed48 sets the value of X t to the 48-bit value specified in the argument array. In 
addition, the previous value of X, is copied into a 48-bit internal buffer, used only by seed48, and a pointer 
to this buffer is the value returned by seed48. This returned pointer, which can just be ignored if not 
needed, is useful if a program is to be restarted from a given point at some future time — use the pointer to 
get at and store the last A, value, and then use this value to reinitialize via seed48 when the program is res¬ 
tarted. 

The initialization function lcong48 allows the user to specify the initial X,, the multiplier value a, and the 
addend value c. Argument array elements param[0-2] specify X ,, param[3-5] specify the multiplier a , 
and param[6] specifies the 16-bit addend c. After lcong48 has been called, a subsequent call to either 
srand48 or seed48 will restore the “standard” multiplier and addend values, a and c, specified on the pre¬ 
vious page. 

NOTES 

The versions of these routines for the VAX-11 and PDP-11 are coded in assembly language for maximum 
speed. It requires approximately 80 (isec on a VAX-11/780 and 130 (isec on a PDP-11/70 to generate one 
pseudo-random number. On other computers, the routines are coded in portable C. The source code for the 
portable version can even be used on computers which do not have floating-point arithmetic. In such a situ¬ 
ation, functions drand48 and erand48 do not exist; instead, they are replaced by the two new functions 
below. 

long irand48 (m) 
unsigned short m; 

long krand48 (xsubi, m) 
unsigned short xsubi[3], m; 

Functions irand48 and krand48 return non-negative long integers uniformly distributed over the interval 

[0, m-1], 

SEE ALSO 

rand(3C). 
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NAME 

ecvt, fcvt, gcvt - convert floating-point number to string 
SYNOPSIS 

char ecvt (value, ndigit, decpt, sign) 

double value; 

int ndigit, decpt, *sign; 

char *fcvt (value, ndigit, decpt, sign) 

double value; 

int ndigit, decpt, *sign; 

char *gcvt (value, ndigit, buf) 
double value; 
char *buf; 

DESCRIPTION 

Ecvt converts value to a null-terminated string of ndigit digits and returns a pointer thereto. The low-order 
digit is rounded. The position of the decimal point relative to the beginning of the string is stored indirectly 
through decpt (negative means to the left of the returned digits). The decimal point is not included in the 
returned string. If the sign of the result is negative, the word pointed to by sign is non-zero, otherwise it is 
zero. 

Fcvt is identical to ecvt, except that the correct digit has been rounded for Fortran F-format output of the 
number of digits specified by ndigit. 

Gcvt converts the value to a null-terminated string in the array pointed to by buf and returns buf. It 
attempts to produce ndigit significant digits in Fortran F-format if possible, otherwise E-format, ready for 
printing. A minus sign, if there is one, or a decimal point will be included as part of the returned string. 
Trailing zeros are suppressed. 

SEE ALSO 

printf(3S). 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

end, etext, edata - last locations in program 

SYNOPSIS 

extern end; 
extern etext; 
extern edata; 

DESCRIPTION 

These names refer neither to routines nor to locations with interesting contents. The address of etext is the 
first address above the program text, edata above the initialized data region, and end above the uninitialized 
data region. 

When execution begins, the program break (the first location beyond the data) coincides with end , but the 
program break may be reset by the routines of brk(2), malloc( 3C), standard input/output (stdio( 3S)), the 
profile (-p) option of cc(l), and so on. Thus, the current value of the program break should be determined 
by sbrk(O) (see brk( 2)). 

SEE ALSO 

brk(2), malloc(3C). 
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NAME 

erf, erfc - error function and complementary error function 

SYNOPSIS 

#include <math.h> 

double erf (x) 
double x; 

double erfc (x) 
double x; 

DESCRIPTION 

X 

2 r 2 

Erf returns the error function of x, defined as —= J e dt. 

V7T 0 

Erfc , which returns 1.0 - erf(x), is provided because of the extreme loss of relative accuracy if erf(x) is 
called for large x and the result subtracted from 1.0 (e.g. for x = 5, 12 places are lost). 

SEE ALSO 

exp(3M). 
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NAME 

exp, dexp, cexp - Fortran exponential intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = exp(rl) 

dp2 = dexp(dpl) 
dp2 = exp(dpl) 

cx2 = clog(cxl) 
cx2 = exp(cxl) 

DESCRIPTION 

Exp returns the real exponential function e x of its real argument. Dexp returns the double-precision expo¬ 
nential function of its double-precision argument. Cexp returns the complex exponential function of its 
complex argument. The generic function exp becomes a call to dexp or cexp as required, depending on the 
type of its argument. 

SEE ALSO 

exp(3M). 
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NAME 

exp, log, loglO, pow, sqrt - exponential, logarithm, power, square root functions 

SYNOPSIS 

#include <math.h> 

double exp (x) 
double x; 

double log (x) 
double x; 

double loglO (x) 
double x; 

double pow (x, y) 
double x, y; 

double sqrt (x) 
double x; 

DESCRIPTION 

Exp returns e x . 

Log returns the natural logarithm of x. The value of x must be positive. 

LoglO returns the logarithm base ten of x. The value of x must be positive. 

Pow returns ,r . The values of x and y may not both be zero. If x is non-positive, y must be an integer. 

Sqrt returns the square root of x. The value of x may not be negative. 

DIAGNOSTICS 

Exp returns HUGE when the correct value would overflow, and sets errno to ERANGE. 

Log and loglO return 0 and set errno to EDOM when x is non-positive. An error message is printed on the 
standard error output. 

Pow returns 0 and sets errno to EDOM when x is non-positive and y is not an integer, or when x and y are 
both zero. In these cases a message indicating DOMAIN error is printed on the standard error output. When 
the correct value for pow would overflow, pow returns HUGE and sets errno to ERANGE. 

Sqrt returns 0 and sets errno to EDOM when x is negative. A message indicating DOMAIN error is printed 
on the standard error output. 

These error-handling procedures may be changed with the function matherr( 3M). 

SEE ALSO 

hypot(3M), matherr(3M), sinh(3M). 
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NAME 

fclose, fflush - close or flush a stream 

SYNOPSIS 

#include <stdio h> 

int fclose (stream) 

FILE * stream; 

int fflush (stream) 

FILE * stream; 

DESCRIPTION 

Fclose causes any buffered data for the named stream to be written out, and the stream to be closed. 

Fclose is performed automatically for all open files upon calling exit( 2). 

Fflush causes any buffered data for the named stream to be written to that file. The stream remains open. 
DIAGNOSTICS 

These functions return 0 for success, and EOF if any error (such as trying to write to a file that has not been 
opened for writing) was detected. 

SEE ALSO 

close(2), exit(2), fopen(3S), setbuf(3S). 
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NAME 

ferror, feof, clearerr, fileno - stream status inquiries 

SYNOPSIS 

#include <stdio h> 

int feof (stream) 

FILE 

^stream; 

int ferror (stream) 

FILE 

^stream; 

void clearerr (stream) 

FILE 

^stream; 

int fileno(stream) 

FILE 

^stream; 

DESCRIPTION 

Feof returns non-zero when EOF has previously been detected reading the named input stream, otherwise 
zero. 

Ferror returns non-zero when an I/O error has previously occurred reading from or writing to the named 
stream, otherwise zero. 

Clearerr resets the error indicator and EOF indicator to zero on the named stream. 

Fileno returns the integer file descriptor associated with the named stream-, see open( 2). 

NOTE 

All these functions are implemented as macros; they cannot be declared or redeclared. 

SEE ALSO 

open(2), fopen(3S). 
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NAME 

floor, ceil, fmod, fabs - floor, ceiling, remainder, absolute value functions 

SYNOPSIS 

#include <math.h> 

double floor (x) 
double x; 

double ceil (x) 
double x; 

double fmod (x, y) 
double x, y; 

double fabs (x) 
double x; 

DESCRIPTION 

Floor returns the largest integer (as a double-precision number) not greater than x. 

Ceil returns the smallest integer not less than x. 

Fmod returns x if y is zero, otherwise the number / with the same sign as x, such that x = iy + f for some 
integer ;, and | /1 < | y \ . 

Fabs returns | x I . 

SEE ALSO 

abs(3C). 
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NAME 

fopen, freopen, fdopen - open a stream 

SYNOPSIS 

#include <stdio h> 

FILE *fopen (file-name, type) 
char file-name, Hype; 

FILE *freopen (file-name, type, stream) 
char file-name, Hype; 

FILE * stream; 

FILE *fdopen (hides, type) 
int Hides; 
char Hype; 

DESCRIPTION 

Fopen opens the file named by file-name and associates a stream with it. Fopen returns a pointer to the 
FILE structure associated with the stream. 

File-name points to a character string that contains the name of the file to be opened. 

Type is a character string having one of the following values: 

"r" open for reading 

"w" truncate or create for writing 

"a" append; open for writing at end of file, or create for writing 

"r+" open for update (reading and writing) 

"w+" truncate or create for update 

"a+" append; open or create for update at end-of-file 

Freopen substitutes the named file in place of the open stream . The original stream is closed, regardless of 
whether the open ultimately succeeds. Freopen returns a pointer to the FILE structure associated with 
stream. 

Freopen is typically used to attach the preopened streams associated with stdin, stdout and stderr to other 
files. 

Fdopen associates a stream with a file descriptor obtained from open, dup, creat, or piped), which will 
open files but not return pointers to a FILE structure stream which are necessary input for many of the sec¬ 
tion 3S library routines. The type of stream must agree with the mode of the open file. 

When a file is opened for update, both input and output may be done on the resulting stream. However, 
output may not be directly followed by input without an intervening fseek or rewind, and input may not be 
directly followed by output without an intervening fseek, rewind, or an input operation which encounters 
end-of-file. 

When a file is opened for append (i.e., when type is "a" or "a+" ), it is impossible to overwrite information 
already in the file. Fseek may be used to reposition the file pointer to any position in the file, but when out¬ 
put is written to the file the current file pointer is disregarded. All output is written at the end of the file and 
causes the file pointer to be repositioned at the end of the output. If two separate processes open the same 
file for append, each process may write freely to the file without fear of destroying output being written by 
the other. The output from the two processes will be intermixed in the file in the order in which it is writ¬ 
ten. 

SEE ALSO 

open(2), fclose(3S). 
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DIAGNOSTICS 

Fopen and freopen return a NULL pointer on failure. 
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NAME 

fread, fwrite - binary input/output 

SYNOPSIS 

#include <stdio h> 

int fread (ptr, size, nitems, stream) 

char ptr; 

int size, nitems; 

FILE * stream; 

int fwrite (ptr, size, nitems, stream) 

char ptr; 

int size, nitems; 

FILE * stream; 

DESCRIPTION 

Fread copies, into an array beginning at ptr, nitems items of data from the named input stream, where an 
item of data is a sequence of bytes (not necessarily terminated by a null byte) of length size. Fread stops 
appending bytes if an end-of-file or error condition is encountered while reading stream, or if nitems items 
have been read. Fread leaves the file pointer in stream, if defined, pointing to the byte following the last 
byte read if there is one. Fread does not change the contents of stream. 

Fwrite appends at most nitems items of data from the the array pointed to by ptr to the named output 
stream. Fwrite stops appending when it has appended nitems items of data or if an error condition is 
encountered on stream. Fwrite does not change the contents of the array pointed to by ptr. 

The variable size is typically sizeof(*ptr) where the pseudo-function sizeof specifies the length of an item 
pointed to by ptr. If ptr points to a data type other than char it should be cast into a pointer to char. 

SEE ALSO 

read(2), write(2), fopen(3S), getc(3S), gets(3S), printf(3S), putc(3S), puts(3S), scanf(3S). 

DIAGNOSTICS 

Fread and fwrite return the number of items read or written. If nitems is non-positive, no characters are 
read or written and 0 is returned by both fread and fwrite. 
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NAME 

frexp, ldexp, modf - manipulate parts of floating-point numbers 
SYNOPSIS 

double frexp (value, eptr) 
double value; 
int *eptr; 

double ldexp (value, exp) 
double value; 
int exp; 

double modf (value, iptr) 
double value, iptr; 

DESCRIPTION 

Every non-zero number can be written uniquely as x * 2", where the “mantissa” (fraction) x is in the range 
0.5 < I x I <1.0, and the “exponent” n is an integer. Frexp returns the mantissa of a double value , and 
stores the exponent indirectly in the location pointed to by eptr. 

Ldexp returns the quantity value * 2 exp . 

Modf returns the signed fractional part of value and stores the integral part indirectly in the location pointed 
to by iptr. 

DIAGNOSTICS 

If ldexp would cause overflow, HUGE is returned and errno is set to ERANGE. 
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NAME 

fseek, rewind, ftell - reposition a file pointer in a stream 

SYNOPSIS 

#include <stdio h> 

int fseek (stream, offset, ptrname) 

FILE * stream; 
long offset; 
int ptrname; 

void rewind (stream) 

FILE * stream; 

long ftell (stream) 

FILE * stream; 

DESCRIPTION 

Fseek sets the position of the next input or output operation on the stream . The new position is at the 
signed distance offset bytes from the beginning, from the current position, or from the end of the file, 
according as ptrname has the value 0, 1, or 2. 

Rewind (stream) is equivalent to fseek(stream, 0L, 0), except that no value is returned. 

Fseek and rewind undo any effects of ungetci 3S). 

After fseek or rewind , the next operation on a file opened for update may be either input or output. 

Ftell returns the offset of the current byte relative to the beginning of the file associated with the named 
stream. 

SEE ALSO 

lseek(2), fopen(3S). 

DIAGNOSTICS 

Fseek returns non-zero for improper seeks, otherwise zero. An improper seek can be, for example, an fseek 
done on a file that has not been opened via fopen ; in particular, fseek may not be used on a terminal, or on a 
file opened via popen( 3S). 

WARNING 

Although on the UNIX System an offset returned by ftell is measured in bytes, and it is permissible to seek 
to positions relative to that offset, portability to non-UNIX Systems requires that an offset be used by fseek 
directly. Arithmetic may not meaningfully be performed on such a offset, which is not necessarily mea¬ 
sured in bytes. 
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NAME 

ftw - walk a file tree 

SYNOPSIS 

#include <ftw.h> 

int ftw (path, fn, depth) 
char path; 
int (*fn) (); 
int depth; 

DESCRIPTION 

Ftw recursively descends the directory hierarchy rooted in path. For each object in the hierarchy, ftw calls 
fn, passing it a pointer to a null-terminated character string containing the name of the object, a pointer to a 
stat structure (see stat( 2)) containg information about the object, and an integer. Possible values of the 
integer, defined in the <ftw h> header file, are FTW F for a file, FTW D for a directory, FTW DNR for a 
directory that cannot be read, and FTW NS for an object for which stat could not successfully be executed. 
If the integer is FTW DNR, descendants of that directory will not be processed. If the integer is FTW NS, 
the stat structure will contain garbage. An example of an object that would cause FTW NS to be passed to 
fn would be a file in a directory with read but without execute (search) permission. 

Ftw visits a directory before visiting any of its descendants. 

The tree traversal continues until the tree is exhausted, an invocation of fn returns a nonzero value, or some 
error is detected within ftw (such as an I/O error). If the tree is exhausted, ftw returns zero. If //; returns a 
nonzero value, ftw stops its tree traversal and returns whatever value was returned by fn. If ftw detects an 
error, it returns -1, and sets the error type in errno. 

Ftw uses one file descriptor for each level in the tree. The depth argument limits the number of file 
descriptors so used. If depth is zero or negative, the effect is the same as if it were 1. Depth must not be 
greater than the number of file descriptors currently available for use. Ftw will run more quickly if depth is 
at least as large as the number of levels in the tree. 

SEE ALSO 

stat(2), malloc(3C). 

BUGS 

Because//w is recursive, it is possible for it to terminate with a memory fault when applied to very deep file 
structures. 

It could be made to run faster and use less storage on deep structures at the cost of considerable complexity. 
Ftw uses malloci 3C) to allocate dynamic storage during its operation. If ftw is forcibly terminated, such as 
by longjmp being executed by fn or an interrupt routine, ftw will not have a chance to free that storage, so it 
will remain permanently allocated. A safe way to handle interrupts is to store the fact that an interrupt has 
occurred, and arrange to have/;; return a nonzero value at its next invocation. 
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NAME 

int, ifix, idint, real, float, sngl, dble, cmplx, dcmplx, ichar, char - explicit Fortran type conversion 

SYNOPSIS 

integer i, j 
real r, s 

double precision dp, dq 
complex cx 
double complex dcx 
character* 7 ch 

i = int(r) 
i = int(dp) 
i = int(cx) 
i = int(dcx) 
i = ifix(r) 
i = idint(dp) 

r = real(i) 
r = real(dp) 
r = real(cx) 
r = real(dcx) 
r = float(i) 
r = sngl(dp) 

dp = dble(i) 
dp = dble(r) 
dp = dble(cx) 
dp = dble(dcx) 

cx = cmplx(i) 
cx = cmplx(i, j) 
cx = cmplx(r) 
cx = cmplx(r, s) 
cx = cmplx(dp) 
cx = cmplx(dp, dq) 
cx = cmplx(dcx) 

dcx = dcmplx(i) 
dcx = dcmplx(i, j) 
dcx = dcmplx(r) 
dcx = dcmplx(r, s) 
dcx = dcmplx(dp) 
dcx = dcmplx(dp, dq) 
dcx = dcmplx(cx) 

i = ichar(ch) 
ch = char(i) 

DESCRIPTION 

These functions perform conversion from one data type to another. 

int converts to integer form its real, double precision, complex, or double complex argument. If the argu¬ 
ment is real or double precision, int returns the integer whose magnitude is the largest integer that does not 
exceed the magnitude of the argument and whose sign is the same as the sign of the argument (i.e. trunca¬ 
tion). For complex types, the above rule is applied to the real part, ifix and idint convert only real and 
double precision arguments respectively. 
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real converts to real form an integer, double precision, complex, or double complex argument. If the argu¬ 
ment is double precision or double complex, as much precision is kept as is possible. If the argument is one 
of the complex types, the real part is returned, float and sngl convert only integer and double precision 
arguments respectively. 

dble converts any integer, real, complex, or double complex argument to double precision form. If the 
argument is of a complex type, the real part is returned. 

cmplx converts its integer, real, double precision, or double complex argument!s) to complex form. 

dcmplx converts to double complex form its integer, real, double precision, or complex argument(s). 

Either one or two arguments may be supplied to cmplx and dcmplx . If there is only one argument, it is 
taken as the real part of the complex type and a imaginary part of zero is supplied. If two arguments are 
supplied, the first is taken as the real part and the second as the imaginary part. 

ichar converts from a character to an integer depending on the character’s position in the collating 
sequence. 

char returns the character in the ;th position in the processor collating sequence where i is the supplied 
argument. 

For a processor capable of representing n characters. 


ichar(char(i)) = i for 0 <= i < n, and 

chart ichar (ch)) = ch for any representable character ch. 
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NAME 

gamma - log gamma function 

SYNOPSIS 

#include <math.h> 

extern int signgam; 

double gamma (x) 
double x; 

DESCRIPTION 

Gamma returns ln(|r( x)|), where T( x) is defined as f e~'t x ~ x dt. The sign of Y( x) is returned in the 

o 

external integer signgam . The argument x may not be a non-positive integer. 

The following C program fragment might be used to calculate F: 

if ((y = gamma(x)) > LOGHUGE) 
errorQ; 

y = signgam * exp(y); 

where LOGHUGE is the least value that causes exp{ 3M) to return a range error. 

DIAGNOSTICS 

For non-negative integer arguments HUGE is returned, and errno is set to EDOM. A message indicating 
DOMAIN error is printed on the standard error output. 

If the correct value would overflow, gamma returns HUGE and sets errno to ERANGE. 

These error-handling procedures may be changed with the function matherr( 3M). 

SEE ALSO 

exp(3M), matherr(3M). 
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NAME 

getarg - return Fortran command-line argument 

SYNOPSIS 

character ^ c 
integer i 

getarg(i, c) 

DESCRIPTION 

Getarg returns the ;-th command-line argument of the current process. Thus, if a program were invoked via 
foo argl arg2 arg3 

getarg(2, c) would return the string “arg2” in the character variable c. 

SEE ALSO 

getopt(3C). 


Page 1 



GETC(3S) 


GETC(3S) 


NAME 

getc, getchar, fgetc, getw - get character or word from stream 

SYNOPSIS 

#include <stdio h> 

int getc (stream) 

FILE * stream; 

int getchar () 

int fgetc (stream) 

FILE * stream; 

int getw (stream) 

FILE * stream; 

DESCRIPTION 

Getc returns the next character (i.e. byte) from the named input stream. It also moves the file pointer, if 
defined, ahead one character in stream. Getc is a macro and so cannot be used if a function is necessary; 
for example one cannot have a function pointer point to it. 

Getchar returns the next character from the standard input stream, stdin. As in the case of getc , getchar is 
a macro. 

Fgetc performs the same function as getc , but is a genuine function. Fgetc runs more slowly than getc , but 
takes less space per invocation. 

Getw returns the next word (i.e. integer) from the named input stream. The size of a word varies from 
machine to machine. It returns the constant EOF upon end-of-file or error, but as that is a valid integer 
value, feof and ferror (3S) should be used to check the success of getw. Getw increments the associated file 
pointer, if defined, to point to the next word. Getw assumes no special alignment in the file. 

SEE ALSO 

fclose(3S), ferror(3S), fopen(3S), fread(3S), gets(3S), putc(3S), scanf(3S). 

DIAGNOSTICS 

These functions return the integer constant EOF at end-of-file or upon an error. 

BUGS 

Because it is implemented as a macro, getc treats incorrectly a stream argument with side effects. In par¬ 
ticular, getc(*f++) doesn’t work sensibly. Fgetc should be used instead. 

Because of possible differences in word length and byte ordering, files written using putw are machine- 
dependent, and may not be read using getw on a different processor. 
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NAME 

getcwd - get path-name of current working directory 
SYNOPSIS 

char getcwd (buf, size) 
char *buf; 
int size; 

DESCRIPTION 

Getcwd returns a pointer to the current directory path-name. The value of size must be at least two greater 
than the length of the path-name to be returned. 

If buf is a NULL pointer, getcwd will obtain size bytes of space using malloc{ 3C). In this case, the pointer 
returned by getcwd may be used as the argument in a subsequent call to free. 

The function is implemented by using popen( 3S) to pipe the output of the pwd( 1) command into the 
specified string space. 

EXAMPLE 

char *cwd, *getcwd(); 


if ((cwd = getcwd((char *)NULL, 64)) == NULL) { 
perrorf “pwd”); 
exit(l); 

} 

printff “%s\n'\ cwd); 

SEE ALSO 

pwd(l), malloc(3C), popen(3S). 

DIAGNOSTICS 

Returns NULL with errno set if size is not large enough, or if an error ocurrs in a lower-level function. 
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NAME 

getenv - return value for environment name 

SYNOPSIS 

char *getenv (name) 
char *name; 

DESCRIPTION 

Getenv searches the environment list (see environ (5)) for a string of the form name=value, and returns a 
pointer to the value in the current environment if such a string is present, otherwise a NULL pointer. 

SEE ALSO 

environ(5). 
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NAME 

getenv - return Fortran environment variable 

SYNOPSIS 

character ^ c 

getenv("TMPDIR", c) 

DESCRIPTION 

Getenv returns the character-string value of the environment variable represented by its first argument into 
the character variable of its second argument. If no such environment variable exists, all blanks will be 
returned. 

SEE ALSO 

getenv(3C), environ(5). 
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NAME 

getgrent, getgrgid, getgrnam, setgrent, endgrent - get group file entry 

SYNOPSIS 

#include <grp.h> 

struct group *getgrent () 

struct group *getgrgid (gid) 
int gid; 

struct group *getgrnam (name) 
char *name; 

void setgrent () 

void endgrent () 

DESCRIPTION 

Getgrent, getgrgid and getgrnam each return pointers to an object with the following structure containing 
the broken-out fields of a line in the /etc/group file. Each line contains a “group” structure, defined in the 
<grp.h> header file. 


struct group { 



char 

*gr name; 

/* the name of the group *■/ 

char 

*gr_passwd; 

/* the encrypted group password *■/ 

int 

grgid; 

/* the numerical group ID */ 

char 

**gr mem; 

/* vector of pointers to member names */ 


}; 

Getgrent when first called returns a pointer to the first group structure in the file; thereafter, it returns a 
pointer to the next group structure in the file; so, successive calls may be used to search the entire file. 
Getgrgid searches from the beginning of the file until a numerical group id matching gid is found and 
returns a pointer to the particular structure in which it was found. Getgrnam searches from the beginning 
of the file until a group name matching name is found and returns a pointer to the particular structure in 
which it was found. If an end-of-file or an error is encountered on reading, these functions return a NULL 
pointer. 

A call to setgrent has the effect of rewinding the group file to allow repeated searches. Endgrent may be 
called to close the group file when processing is complete. 

FILES 

/etc/group 
SEE ALSO 

getlogin(3C), getpwent(3C), group(4). 

DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 

WARNING 

The above routines use <stdio h>, which causes them to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 

BUGS 

All information is contained in a static area, so it must be copied if it is to be saved. 
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NAME 

getlogin - get login name 

SYNOPSIS 

char 'getlogin (); 

DESCRIPTION 

Getlogin returns a pointer to the login name as found in /etc/utmp. It may be used in conjunction with 
getpwnam to locate the correct password file entry when the same user ID is shared by several login names. 

If getlogin is called within a process that is not attached to a terminal, it returns a NULL pointer. The cor¬ 
rect procedure for determining the login name is to call cuserid, or to call getlogin and if it fails to call 
getpwuid. 

FILES 

/etc/utmp 
SEE ALSO 

cuserid(3S), getgrent(3C), getpwent(3C), utmp(4). 

DIAGNOSTICS 

Returns the NULL pointer if name not found. 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

getopt - get option letter from argument vector 
SYNOPSIS 

int getopt (argc, argv, optstring) 
int argc; 
char **argv; 
char optstring; 

extern char *optarg; 
extern int optind; 

DESCRIPTION 

Getopt returns the next option letter in argv that matches a letter in optstring. Optstring is a string of rec¬ 
ognized option letters; if a letter is followed by a colon, the option is expected to have an argument that 
may or may not be separated from it by white space. Optarg is set to point to the start of the option argu¬ 
ment on return from getopt. 

Getopt places in optind the argv index of the next argument to be processed. Because optind is external, it 
is normally initialized to zero automatically before the first call to getopt. 

When all options have been processed (i.e., up to the first non-option argument), getopt returns EOF. The 
special option — may be used to delimit the end of the options; EOF will be returned, and — will be 
skipped. 

DIAGNOSTICS 

Getopt prints an error message on stderr and returns a question mark (?) when it encounters an option let¬ 
ter not included in optstring. 

WARNING 

The above routine uses <stdio h>, which causes it to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 

EXAMPLE 

The following code fragment shows how one might process the arguments for a command that can take the 
mutually exclusive options a and b, and the options f and o, both of which require arguments: 

main (argc, argv) 
int argc; 
char **argv; 

{ 

int c; 

extern int optind; 
extern char *optarg; 


while ((c = getopt (argc, argv, "abf:o:")) != EOF) 
switch (c) { 
case 'a: 

if (bflg) 

errflg++; 

else 

aflg++; 

break; 

case 'b': 

if (aflg) 

errflg++; 

else 

bproc( ); 
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break; 

case T: 

ifile = optarg; 
break; 

case 'o': 

ofile = optarg; 
bufsiza = 512; 
break; 

case '?': 

errflg++; 

} 

if (errflg) { 

fprintf (stderr, "usage: . . . "); 
exit (2); 

} 

for ( ; optind < argc; optind++) { 

if (access (argv[optind], 4)) { 

} 

SEE ALSO 

getopt(l). 
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NAME 

getpass - read a password 

SYNOPSIS 

char getpass (prompt) 
char prompt; 

DESCRIPTION 

Getpass reads up to a newline or EOF from the file /dev/tty, after prompting on the standard error output 
with the null-terminated string prompt and disabling echoing. A pointer is returned to a null-terminated 
string of at most 8 characters. If /dev/tty cannot be opened, a NULL pointer is returned. An interrupt will 
terminate input and send an interrupt signal to the calling program before returning. 

FILES 

/dev/tty 

SEE ALSO 

crypt(3C). 

WARNING 

The above routine uses <stdio h>, which causes it to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

getpw - get name from UID 

SYNOPSIS 

int getpw (uid, buf) 
int uid; 
char *buf; 

DESCRIPTION 

Getpw searches the password hie for a user id number that equals uid, copies the line of the password hie 
in which uid was found into the array pointed to by buf, and returns 0. Getpw returns non-zero if uid can¬ 
not be found. 

This routine is included only for compatibility with prior systems and should not be used; see getpwent( 3C) 
for routines to use instead. 

FILES 

/etc/passwd 

SEE ALSO 

getpwent(3C), passwd(4). 

DIAGNOSTICS 

Getpw returns non-zero on error. 

WARNING 

The above routine uses <stdio h>, which causes it to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 
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GETPWENT(3C) 


NAME 

getpwent, getpwuid, getpwnam, setpwent, endpwent - get password file entry 

SYNOPSIS 

#include <pwd h> 

struct passwd getpwent () 

struct passwd getpwuid (uid) 
int uid; 

struct passwd getpwnam (name) 
char *name; 

void setpwent () 

void endpwent () 

DESCRIPTION 

Getpwent, getpwuid and getpwnam each returns a pointer to an object with the following structure contain¬ 
ing the broken-out fields of a line in the /etc/passwd file. Each line in the file contains a “passwd” struc¬ 
ture, declared in the <pwd.h> header file: 

struct passwd { 

char *pw name; 

char *pw_passwd; 

int pw uid; 

int pw gid; 

char *pw_age; 

char *p\v comment; 

char *pw_gecos; 

char *pw dir; 

char *pw shell; 


struct comment { 

char *c dept; 

char *c name; 

char *c_acct; 

char *c_bin; 

}; 

This stmcture is declared in <pwd.h> so it is not necessary to redeclare it. 

The pw_comment field is unused; the others have meanings described in passwd{ 4). 

Getpwent when first called returns a pointer to the first passwd structure in the file; thereafter, it returns a 
pointer to the next passwd stmcture in the file; so successive calls can be used to search the entire file. 
Getpwuid searches from the beginning of the file until a numerical user id matching uid is found and 
returns a pointer to the particular structure in which it was found. Getpwnam searches from the beginning 
of the file until a login name matching name is found, and returns a pointer to the particular structure in 
which it was found. If an end-of-file or an error is encountered on reading, these functions return a NULL 
pointer. 

A call to setpwent has the effect of rewinding the password file to allow repeated searches. Endpwent may 
be called to close the password file when processing is complete. 

FILES 

/etc/passwd 

SEE ALSO 

getlogin(3C), getgrent(3C), passwd(4). 
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DIAGNOSTICS 

A NULL pointer is returned on EOF or error. 

WARNING 

The above routines use <stdio h>, which causes them to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 

BUGS 

All information is contained in a static area, so it must be copied if it is to be saved. 
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GETS(3S) 


NAME 

gets, fgets - get a string from a stream 

SYNOPSIS 

#include <stdio h> 

char *gets (s) 
char *s; 

char *fgets (s, n, stream) 
char *s; 
int n; 

FILE * stream; 

DESCRIPTION 

Gets reads characters from the standard input stream, stdin, into the array pointed to by ,v, until a new-line 
character is read or an end-of-file condition is encountered. The new-line character is discarded and the 
string is terminated with a null character. 

Fgets reads characters from the stream into the array pointed to by ,v, until n -1 characters are read, or a 
new-line character is read and transferred to s, or an end-of-file condition is encountered. The string is then 
terminated with a null character. 

SEE ALSO 

ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S). 

DIAGNOSTICS 

If end-of-file is encountered and no characters have been read, no characters are transferred to ,v and a NULL 
pointer is returned. If a read error occurs, such as trying to use these functions on a file that has not been 
opened for reading, a NULL pointer is returned. Otherwise s is returned. 
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GETUT(3C) 


NAME 

getutent, getutid, getutline, pututline, setutent, endutent, utmpname - access utmp file entry 

SYNOPSIS 

#include <utmp h> 

struct utmp getutent () 

struct utmp getutid (id) 
struct utmp *id; 

struct utmp getutline (line) 
struct utmp line; 

void pututline (utmp) 
struct utmp utmp; 

void setutent () 

void endutent () 

void utmpname (file) 
char *file; 

DESCRIPTION 

Getutent, getutid and getutline each return a pointer to a structure of the following type: 
sttuct utmp { 


char 

ut user[8]; 

/* User login name */ 

char 

ut_id[4]; 

/* /etc/inittab id (usually line #) */ 

char 

ut line [12]; 

/* device name (console, Inxx) */ 

short 

ut_pid; 

/* process id *■/ 

short 

ut type; 

/* type of entry */ 

struct 

exit status { 


short 

e termination; 

/* Process termination status */ 

short 

e exit; 

/* Process exit status */ 

} ut exit; 


/* The exit status of a process 
* marked as DEAD PROCESS. */ 

time t 

ut time; 

/* time entry was made */ 


}; 

Getutent reads in the next entry from a utmp- like file. If the file is not already open, it opens it. If it 
reaches the end of the file, it fails. 

Getutid searches forward from the current point in the utmp file until it finds an entry with a utjype match¬ 
ing id->ut_type if the type specified is RUN LVL, BOOT TIME, OLD TIME or NEW TIME. If the type 
specified in id is INIT PROCESS, LOGIN PROCESS, USER PROCESS or DEAD PROCESS, then getutid will 
return a pointer to the first entry whose type is one of these four and whose ul id field matches id->ut id. 
If the end of file is reached without a match, it fails. 

Getutline searches forward from the current point in the utmp file until it finds an entry of the type 
LOGIN PROCESS or USER PROCESS which also has a utjine suing matching the line->ut line string. If 
the end of file is reached without a match, it fails. 

Pututline writes out the supplied utmp structure into the utmp file. It uses getutid to search forward for the 
proper place if it finds that it is not already at the proper place. It is expected that normally the user of 
pututline will have searched for the proper entry using one of the getut routines. If so, pututline will not 
search. If pututline does not find a matching slot for the new enUy, it will add a new entry to the end of the 
file. 

Setutent resets the input stream to the beginning of the file. This should be done before each search for a 
new enUy if it is desired that the entire file be examined. 
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Endutent closes the currently open file. 

Utmpname allows the user to change the name of the file examined, from /etc/utmp to any other file. It is 
most often expected that this other file will be /etc/wtmp. If the file doesn’t exist, this will not be apparent 
until the first attempt to reference the file is made. Utmpname does not open the file. It just closes the old 
file if it is currently open and saves the new file name. 

FILES 

/etc/utmp 

/etc/wtmp 

SEE ALSO 

ttyslot(3C), utmp(4). 

DIAGNOSTICS 

A NULL pointer is returned upon failure to read, whether for permissions or having reached the end of file, 
or upon failure to write. 

COMMENTS 

The most current entry is saved in a static structure. Multiple accesses require that it be copied before fur¬ 
ther accesses are made. Each call to either getutid or getutline sees the routine examine the static structure 
before performing more I/O. If the contents of the static structure match what it is searching for, it looks no 
further. For this reason to use getutline to search for multiple occurences, it would be necessary to zero out 
the static after each success, or getutline would just return the same pointer over and over again. There is 
one exception to the rule about removing the structure before further reads are done. The implicit read done 
by pututline if it finds that it isn't already at the correct place in the file will not hurt the contents of the 
static structure returned by the getutent, getutid or getutline routines, if the user has just modified those 
contents and passed the pointer back to pututline. 

These routines use buffered standard I/O for input, but pututline uses an unbuffered non-standard write to 
avoid race conditions between processes trying to modify the utinp and wtmp files. 
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NAME 

hsearch, hcreate, hdestroy - manage hash search tables 

SYNOPSIS 

#include <search h> 

ENTRY *hsearch (item, action) 

ENTRY item; 

ACTION action; 

int hcreate (nel) 
unsigned nel; 

void hdestroy () 

DESCRIPTION 

Hsearch is a hash-table search routine generalized from Knuth (6.4) Algorithm D. It returns a pointer into 
a hash table indicating the location at which an entry can be found. Item is a structure of type ENTRY 
(defined in the <search.h> header file) containing two pointers: item.key points to the comparison key, and 
item.data points to any other data to be associated with that key. (Pointers to types other than character 
should be cast to pointer-to-character.) Action is a member of an enumeration type ACTION indicating the 
disposition of the entry if it cannot be found in the table. ENTER indicates that the item should be inserted 
in the table at an appropriate point. FIND indicates that no entry should be made. Unsuccessful resolution 
is indicated by the return of a NULL pointer. 

Hcreate allocates sufficient space for the table, and must be called before hsearch is used, nel is an esti¬ 
mate of the maximum number of entries that the table will contain. This number may be adjusted upward 
by the algorithm in order to obtain certain mathematically favorable circumstances. 

Hdestroy destroys the search table, and may be followed by another call to hcreate. 

NOTES 

Hsearch uses open addressing with a multiplicative hash function. However, its source code has many 
other options available which the user may select by compiling the hsearch source with the following sym¬ 
bols defined to the preprocessor: 

DIV Use the remainder modulo table size as the hash function instead of the multiplicative 

algorithm. 

USCR Use a User Supplied Comparison Routine for ascertaining table membership. The rou¬ 
tine should be named hcompar and should behave in a mannner similar to strcmp (see 
string( 3C)). 

CHAINED 

Use a linked list to resolve collisions. If this option is selected, the following other 
options become available. 

START Place new entries at the beginning of the linked list (default is at the end). 
SORTUP Keep the linked list sorted by key in ascending order. 

SORTDOWN 

Keep the linked list sorted by key in descending order. 

Additionally, there are preprocessor flags for obtaining debugging printout (-DDEBUG) and for including a 
test driver in the calling routine (-DDRIVER). The source code should be consulted for further details. 

SEE ALSO 

bsearch(3C), lsearch(3C), string(3C), tsearch(3C). 

DIAGNOSTICS 

Hsearch returns a NULL pointer if either the action is FIND and the item could not be found or the action is 
ENTER and the table is full. 
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Hcreate returns zero if it cannot allocate sufficient space for the table. 

BUGS 

Only one hash search table may be active at any given time. 
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NAME 

hypot - Euclidean distance function 

SYNOPSIS 

#include <math.h> 

double hypot (x, y) 
double x, y; 

DESCRIPTION 

Hypot returns 

sqrt(x * x + y * y), 

taking precautions against unwarranted overflows. 

DIAGNOSTICS 

When the correct value would overflow, hypot returns HUGE and sets errno to ERANGE. 
These error-handling procedures may be changed with the function matherr( 3M). 

SEE ALSO 

matherr(3M), sqrt(3F). 
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NAME 

index - return location of Fortran substring 

SYNOPSIS 

character*Nl chi 
character*N2 ch2 
integer i 

i = index(chl, ch2) 

DESCRIPTION 

Index returns the location of substring ch2 in string chi. The value returned is the position at which sub- 
stting ch2 starts, or 0 is it is not present in string chi. 
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NAME 

13tol, ltol3 - convert between 3-byte integers and long integers 

SYNOPSIS 

void 13tol (lp, cp, n) 
long *lp; 
char cp; 
int n; 

void ltol3 (cp, lp, n) 
char cp; 
long *lp; 
int n; 

DESCRIPTION 

L3tol converts a list of n three-byte integers packed into a character string pointed to by cp into a list of 
long integers pointed to by Ip. 

Ltol3 performs the reverse conversion from long integers (lp ) to three-byte integers (cp). 

These functions are useful for file-system maintenance where the block numbers are three bytes long. 

SEE ALSO 

fs(4). 

BUGS 

Because of possible differences in byte ordering, the numerical values of the long integers are machine- 
dependent. 
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LDAHREAD (3X) 


NAME 

ldahread - read the archive header of a member of an archive file 

SYNOPSIS 

#include <stdio h> 

#include <ar h> 

#include <filehdr h> 

#include <ldfcn h> 

int ldahread (Idptr, arhead) 

LDFILE *ldptr; 

ARCHDR *arhead; 

DESCRIPTION 

If TYPE(Mpfr) is the archive file magic number, ldahread reads the archive header of the common object 
file currently associated with Idptr into the area of memory beginning at arhead. 

Ldahread returns SUCCESS or FAILURE. Ldahread will fail if TYPE (Idptr) does not represent an archive 
file, or if it cannot read the archive header. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldfcn(4). 
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(not on PDP-11) 


LDCLOSE(3X) 


NAME 

Idclose, ldaclose - close a common object file 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <ldfcn h> 

int Idclose (ldptr) 

LDFILE *ldptr; 

int ldaclose (ldptr) 

LDFILE *ldptr; 

DESCRIPTION 

Ldopen(3X) and Idclose are designed to provide uniform access to both simple object files and object files 
that are members of archive files. Thus an archive of common object files can be processed as if it were a 
series of simple common object files. 

If TYPE {ldptr) does not represent an archive file, Idclose will close the file and free the memory allocated 
to the LDFILE structure associated with ldptr. If TYPE {ldptr) is the magic number of an archive file, and if 
there are any more files in the archive, Idclose will reinitialize OFFSET(Wpfr) to the file address of the next 
archive member and return FAILURE. The LDFILE structure is prepared for a subsequent ldopen( 3X). In 
all other cases, Idclose returns SUCCESS. 

Ldaclose closes the file and frees the memory allocated to the LDFILE structure associated with ldptr 
regardless of the value of TYPE (ldptr). Ldaclose always returns SUCCESS. The function is often used in 
conjunction with Idaopen. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

fclose(3S), ldopen(3X), ldfcn(4). 
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(not on PDP-11) 


LDFHRE AD (3X) 


NAME 

ldfhread - read the file header of a common object file 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <ldfcn h> 

int ldfhread (Idptr, filehead) 

LDFILE *ldptr; 

FILHDR * filehead; 

DESCRIPTION 

Ldfhread reads the file header of the common object file currently associated with Idptr into the area of 
memory beginning at filehead. 

Ldfhread returns SUCCESS or FAILURE. Ldfhread will fail if it cannot read the file header. 

In most cases the use of ldfhread can be avoided by using the macro HEADERjMpfr) defined in ldfcn h 
( seeldfcn(4 )). The information in any field, fieldname, of the file header may be accessed using 
HEADER (Idptr).fieldname. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldfcn(4). 
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(not on PDP-11) 


LDLREAD(3X) 


NAME 

ldlread, ldlinit, Idlitem - manipulate line number entries of a common object file function 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <linenum.h> 

#include <ldfcn h> 

int ldlread(ldptr, fcnindx, linenum, linent) 

LDFILE *ldptr; 
long fcnindx; 
unsigned short linenum; 

LINENO linent; 

int ldlinit(ldptr, fcnindx) 

LDFILE *ldptr; 
long fcnindx; 

int ldlitem(ldptr, linenum, linent) 

LDFILE *ldptr; 
unsigned short linenum; 

LINENO linent; 

DESCRIPTION 

Ldlread searches the line number entries of the common object file currently associated with Idptr. Ldlread 
begins its search with the line number entry for the beginning of a function and confines its search to the 
line numbers associated with a single function. The function is identified by fcnindx, the index of its entry 
in the object file symbol table. Ldlread reads the entry with the smallest line number equal to or greater 
than linenum into linent. 

Ldlinit and Idlitem together perform exactly the same function as ldlread. After an initial call to ldlread or 
ldlinit, Idlitem may be used to retrieve a series of line number entries associated with a single function. 
Ldlinit simply locates the line number entries for the function identified by fcnindx. Ldlitem finds and reads 
the entry with the smallest line number equal to or greater than linenum into linent. 

Ldlread, ldlinit, and Idlitem each return either SUCCESS or FAILURE. Ldlread will fail if there are no line 
number entries in the object file, if fcnindx does not index a function entry in the symbol table, or if it finds 
no line number equal to or greater than linenum. Ldlinit will fail if there are no line number entries in the 
object file or if fcnindx does not index a function entry in the symbol table. Ldlitem will fail if it finds no 
line number equal to or greater than linenum. 

The programs must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldtbindex(3X), ldfcn(4). 
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(not on PDP-11) 


LDLSEEK(3X) 


NAME 

ldlseek.ldnlseek - seek to line number entries of a section of a common object file 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <ldfcn h> 

int Idlseek (Idptr, sectindx) 

LDFILE *ldptr; 
unsigned short sectindx; 

int ldnlseek (Idptr, sectname) 

LDFILE *ldptr; 
char sectname; 

DESCRIPTION 

Ldlseek seeks to the line number entries of the section specified by sectindx of the common object file cur¬ 
rently associated with Idptr. 

Ldnlseek seeks to the line number entries of the section specified by sectname. 

Ldlseek and ldnlseek return SUCCESS or FAILURE. Ldlseek will fail if sectindx is greater than the number 
of sections in the object file; ldnlseek will fail if there is no section name corresponding with * sectname. 
Either function will fail if the specified section has no line number entries or if it cannot seek to the 
specified line number entries. 

Note that the first section has an index of one. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldshread(3X), ldfcn(4). 
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(not on PDP-11) 


LDOHSEEK (3X) 


NAME 

Idohseek - seek to the optional file header of a common object file 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <Idfcn h> 

int Idohseek (Idptr) 

LDFILE *ldptr; 

DESCRIPTION 

Ldohseek seeks to the optional file header of the common object file currently associated with Idptr. 

Ldohseek returns SUCCESS or FAILURE. Ldohseek will fail if the object file has no optional header or if it 
cannot seek to the optional header. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldfhread(3X), ldfcn(4). 
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(not on PDP-11) 


LDOPEN(3X) 


NAME 

Idopen, ldaopen - open a common object file for reading 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <ldfcn h> 

LDFILE *ldopen (filename, Idptr) 
char *filename; 

LDFILE *ldptr; 

LDFILE *ldaopen (filename, oldptr) 
char *filename; 

LDFILE *oldptr; 

DESCRIPTION 

Ldopen and ldclose{ 3X) are designed to provide uniform access to both simple object files and object files 
that are members of archive files. Thus an archive of common object files can be processed as if it were a 
series of simple common object files. 

If Idptr has the value NU11, then Idopen will open filename and allocate and initialize the LDFILE structure, 
and return a pointer to the structure to the calling program. 

If Idptr is valid and if TYPE (Idptr) is the archive magic number, Idopen will reinitialize the LDFILE 
structure for the next archive member of filename. 

Ldopen and Idclose are designed to work in concert. Ldclose will return FAILURE only when TYPE (Idptr) 
is the archive magic number and there is another file in the archive to be processed. Only then should 
Idopen be called with the current value of Idptr. In all other cases, in particular whenever a new filename is 
opened, Idopen should be called with a NULL Idptr argument. 

The following is a prototype for the use of Idopen and Idclose. 

/*■ for each filename to be processed *■/ 

Idptr = NULL; 
do 

if ((Idptr = ldopen(filename, Idptr)) != NULL ) 


/* check magic number */ 
/* process the file *■/ 


} while (ldclose(ldptr) == FAILURE ); 

If the value of oldptr is not NULL, ldaopen will open filename anew and allocate and initialize a new 
LDFILE structure, copying the TYPE, OFFSET, and HEADER fields from oldptr. Ldaopen returns a 
pointer to the new LDFILE structure. This new pointer is independent of the old pointer, oldptr. The two 
pointers may be used concurrently to read separate parts of the object file. For example, one pointer may be 
used to step sequentially through the relocation information, while the other is used to read indexed symbol 
table entries. 

Both Idopen and ldaopen open filename for reading. Both functions return NULL if filename cannot be 
opened, or if memory for the LDFILE structure cannot be allocated. A successful open does not insure that 
the given file is a common object file or an archived object file. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

fopen(3S), ldclose(3X), ldfcn(4). 
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(not on PDP-11) 


LDRSEEK(3X) 


NAME 

ldrseek, ldnrseek - seek to relocation entries of a section of a common object file 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <ldfcn h> 

int ldrseek (ldptr, sectindx) 

LDFILE *ldptr; 
unsigned short sectindx; 

int ldnrseek (ldptr, sectname) 

LDFILE *ldptr; 
char sectname; 

DESCRIPTION 

Ldrseek seeks to the relocation entries 
rently associated with ldptr. 

Ldnrseek seeks to the relocation entries 

Ldrseek and ldnrseek return SUCCESS or FAILURE. Ldrseek will fail if sectindx is greater than the number 
of sections in the object file; ldnrseek will fail if there is no section name corresponding with sectname. 
Either function will fail if the specified section has no relocation entries or if it cannot seek to the specified 
relocation entries. 

Note that the first section has an index of one. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldshread(3X), ldfcn(4). 


of the section specified by sectindx of the common object file cur- 
of the section specified by sectname. 
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(not on PDP-11) 


LDSHREAD (3X) 


NAME 

ldshread, ldnshread - read an indexed/named section header of a common object file 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <scnhdr h> 

#include <ldfcn h> 

int ldshread (Idptr, sectindx, secthead) 

LDFILE *ldptr; 
unsigned short sectindx; 

SCNHDR *secthead; 

int ldnshread (Idptr, sectname, secthead) 

LDFILE *ldptr; 
char sectname; 

SCNHDR *secthead; 

DESCRIPTION 

Ldshread reads the section header specified by sectindx of the common object file currently associated with 
Idptr into the area of memory beginning at secthead. 

Ldnshread reads the section header specified by sectname into the area of memory beginning at secthead. 

Ldshread and ldnshread return SUCCESS or FAILURE. Ldshread will fail if sectindx is greater than the 
number of sections in the object file; ldnshread will fail if there is no section name corresponding with 
sectname. Either function will fail if it cannot read the specified section header. 

Note that the first section header has an index of one. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldfcn(4). 
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(not on PDP-11) 


LDSSEEK(3X) 


NAME 

Idsseek, ldnsseek - seek to an indexed/named section of a common object file 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <ldfcn h> 

int Idsseek (Idptr, sectindx) 

LDFILE *ldptr; 
unsigned short sectindx; 

int ldnsseek (Idptr, sectname) 

LDFILE *ldptr; 
char sectname; 

DESCRIPTION 

Ldsseek seeks to the section specified by sectindx of the common object file currently associated with Idptr. 
Ldnsseek seeks to the section specified by sectname. 

Ldsseek and ldnsseek return SUCCESS or FAILURE. Ldsseek will fail if sectindx is greater than the number 
of sections in the object file; ldnsseek will fail if there is no section name corresponding with sectname. 
Either function will fail if there is no section data for the specified section or if it cannot seek to the 
specified section. 

Note that the first section has an index of one. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldshread(3X), ldfcn(4). 
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(not on PDP-11) 


LDTBINDEX (3X) 


NAME 

Idtbindex - compute the index of a symbol table entry of a common object file 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <syms.h> 

#include <ldfcn h> 

long Idtbindex (ldptr) 

LDFILE *ldptr; 

DESCRIPTION 

Ldtbindex returns the (long) index of the symbol table entry at the current position of the common object 
file associated with ldptr. 

The index returned by Idtbindex may be used in subsequent calls to ldtbread( 3X). However, since 
Idtbindex returns the index of the symbol table entry that begins at the current position of the object file, if 
Idtbindex is called immediately after a particular symbol table entry has been read, it will return the the 
index of the next entry. 

Ldtbindex will fail if there are no symbols in the object file, or if the object file is not positioned at the 
beginning of a symbol table entry. 

Note that the first symbol in the symbol table has an index of zero. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldtbread(3X), ldtbseek(3X), ldfcn(4). 
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LDTBREAD (3X) 


NAME 

ldtbread - read an indexed symbol table entry of a common object file 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <syms.h> 

#include <ldfcn h> 

int ldtbread (ldptr, symindex, symbol) 

LDFILE * ldptr; 
long symindex; 

SYMENT * symbol; 

DESCRIPTION 

Ldtbread reads the symbol table entry specified by symindex of the common object file currently associated 
with ldptr into the area of memory beginning at symbol. 

Ldtbread returns SUCCESS or FAILURE. Ldtbread will fail if symindex is greater than the number of sym¬ 
bols in the object file, or if it cannot read the specified symbol table entry. 

Note that the first symbol in the symbol table has an index of zero. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldtbseek(3X), ldfcn(4). 
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NAME 

ldtbseek - seek to the symbol table of a common object file 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <ldfcn h> 

int ldtbseek (Idptr) 

LDFILE * Idptr; 

DESCRIPTION 

Ldtbseek seeks to the symbol table of the object file currently associated with Idptr. 

Ldtbseek return SUCCESS or FAILURE. Ldtbseek will fail if the symbol table has been stripped from the 
object file, or if it cannot seek to the symbol table. 

The program must be loaded with the object file access routine library libld.a. 

SEE ALSO 

ldclose(3X), ldopen(3X), ldtbread(3X), ldfcn(4). 
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NAME 

len - return length of Fortran string 

SYNOPSIS 

character ^ ch 
integer i 

i = len(ch) 

DESCRIPTION 

Len returns the length of string ch. 
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NAME 

log, alog, dlog, clog - Fortran natural logarithm intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = alog(rl) 
r2 = log(rl) 

dp2 = dlog(dpl) 
dp2 = log(dpl) 

cx2 = clog(cxl) 
cx2 = log(cxl) 

DESCRIPTION 

Alog returns the real natural logarithm of its real argument. Dlog returns the double-precision natural loga¬ 
rithm of its double-precision argument. Clog returns the complex logarithm of its complex argument. The 
generic function log becomes a call to alog, dlog, or clog depending on the type of its argument. 

SEE ALSO 

exp(3M). 


Page 1 



LOG10(3F) 


LOG10(3F) 


NAME 

loglO, aloglO, dloglO - Fortran common logarithm intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = aloglO(rl) 
r2 = loglO(rl) 

dp2 = dloglO(dpl) 
dp2 = loglO(dpl) 

DESCRIPTION 

AloglO returns the real common logarithm of its real argument. Dlog returns the double-precision common 
logarithm of its double-precision argument. The generic function log becomes a call to a log or dlog 
depending on the type of its argument. 

SEE ALSO 

exp(3M). 
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NAME 

logname - return login name of user 

SYNOPSIS 

char *logname() 

DESCRIPTION 

Logname returns a pointer to the null-terminated login name; it extracts the $LOGNAME variable from the 
user’s environment. 

This routine is kept in /Iib/libPW.a. 

FILES 

/etc/profile 
SEE ALSO 

env(l), login(l), profile(4), environ(5). 

BUGS 

The return values point to static data whose content is overwritten by each call. 

This method of determining a login name is subject to forgery. 
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NAME 

lsearch - linear search and update 
SYNOPSIS 

char *lsearch ((char *)key, (char *)base, nelp, sizeof(*key), compar) 
unsigned nelp; 
int (*compar)(); 

DESCRIPTION 

Lsearch is a linear search routine generalized from Knuth (6.1) Algorithm S. It returns a pointer into a 
table indicating where a datum may be found. If the datum does not occur, it is added at the end of the 
table. Key points to the datum to be sought in the table. Base points to the first element in the table. Nelp 
points to an integer containing the current number of elements in the table. The integer is incremented if 
the datum is added to the table. Compar is the name of the comparison function which the user must sup¬ 
ply ( strcmp , for example). It is called with two arguments that point to the elements being compared. The 
function must return zero if the elements are equal and non-zero otherwise. 

NOTES 

The pointers to the key and the element at the base of the table should be of type pointer-to-element, and 
cast to type pointer-to-character. 

The comparison function need not compare every byte, so arbitrary data may be contained in the elements 
in addition to the values being compared. 

Although declared as type pointer-to-character, the value returned should be cast into type pointer-to- 
element. 

SEE ALSO 

bsearch(3C), hsearch(3C), tsearch(3C). 

BUGS 

Undefined results can occur if there is not enough room in the table to add a new item. 
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NAME 

malloc, free, realloc, calloc - main memory allocator 

SYNOPSIS 

char *malloc (size) 
unsigned size; 

void free (ptr) 
char *ptr; 

char *realloc (ptr, size) 
char ptr; 
unsigned size; 

char *calloc (nelem, elsize) 
unsigned nelem, elsize; 

DESCRIPTION 

Malloc and free provide a simple general-purpose memory allocation package. Malloc returns a pointer to 
a block of at least size bytes suitably aligned for any use. 

The argument to free is a pointer to a block previously allocated by malloc, after free is performed this 
space is made available for further allocation, but its contents are left undisturbed. 

Undefined results will occur if the space assigned by malloc is overrun or if some random number is 
handed to free. 

Malloc allocates the first big enough contiguous reach of free space found in a circular search from the last 
block allocated or freed, coalescing adjacent free blocks as it searches. It calls sbrk (see brk( 2)) to get more 
memory from the system when there is no suitable space already free. 

Realloc changes the size of the block pointed to by ptr to size bytes and returns a pointer to the (possibly 
moved) block. The contents will be unchanged up to the lesser of the new and old sizes. If no free block of 
size bytes is available in the storage arena, then realloc will ask malloc/* to enlarge the arena by size bytes 
and will then move the data to the new space. 

Realloc also works if ptr points to a block freed since the last call of malloc, realloc, or calloc, thus 
sequences of free, malloc and realloc can exploit the search strategy of malloc to do storage compaction. 

Calloc allocates space for an array of nelem elements of size elsize. The space is initialized to zeros. 

Each of the allocation routines returns a pointer to space suitably aligned (after possible pointer coercion) 
for storage of any type of object. 

DIAGNOSTICS 

Malloc, realloc and calloc return a NULL pointer if there is no available memory or if the arena has been 
detectably corrupted by storing outside the bounds of a block. When this happens the block pointed to by 
ptr may be destroyed. 

NOTE 

Search time increases when many objects have been allocated; that is, if a program allocates but never 
frees, then each successive allocation takes longer. 
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NAME 

matherr - error-handling function 

SYNOPSIS 

#include <math.h> 

int matherr (x) 
struct exception *x; 

DESCRIPTION 

Matherr is invoked by functions in the Math Library when errors are detected. Users may define their own 
procedures for handling errors by including a function named matherr in their programs. Matherr must be 
of the form described above. A pointer to the exception structure x will be passed to the user-supplied 
matherr function when an error occurs. This structure, which is defined in the <math.h> header file, is as 
follows: 

struct exception { 
int type; 
char *name; 

double argl, arg2, retval; 

}; 

The element type is an integer describing the type of error that has occurred, from the following list of con¬ 
stants (defined in the header file): 

DOMAIN domain error 
SING singularity 

OVERFLOW overflow 
UNDERFLOW underflow 
TLOSS total loss of significance 

PLOSS partial loss of significance 

The element name points to a string containing the name of the function that had the error. The variables 
argl and arg2 are the arguments to the function that had the error. Retval is a double that is returned by 
the function having the error. If it supplies a return value, the user’s matherr must return non-zero. If the 
default error value is to be returned, the user’s matherr must return 0. 

If matherr is not supplied by the user, the default error-handling procedures, described with the math func¬ 
tions involved, will be invoked upon error. These procedures are also summarized in the table below. In 
every case, errno is set to non-zero and the program continues. 

EXAMPLE 

matherr(x) 

register struct exception *x; 

{ 

switch (x->type) { 
case DOMAIN: 

case SING: /* print message and abort */ 

fprintfistderr, "domain error in %s\n", x->name); 
abort(); 

case OVERFLOW: 

if (!strcmp("exp", x->name)) { 

/* if exp, print message, return the argument */ 
fprintf(stderr, "exp of %f\n", x->argl); 
x->retval = x->arg 1; 

} else if (!strcmp("sinh", x->name)) { 

/* if sinh, set errno, return 0 */ 
errno = ERANGE; 
x->retval = 0; 
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} else 

/* otherwise, return HUGE */ 
x->retval = HUGE; 

break; 

case UNDERFLOW: 

return (0); /* execute default procedure */ 
case TLOSS: 
case PLOSS: 

/* print message and return 0 */ 

fprintf(stderr, "loss of significance in %s\n", x->name); 

x->retval = 0; 

break; 

} 

return (1); 

} 


DEFAULT ERROR HANDLING PROCEDURES 


Types of Errors 


DOMAIN 

SING 

OVERFLOW 

UNDERFLOW 

TLOSS 

PLOSS 

BESSEL: 

- 

- 

H 

0 

- 

* 

yO, yl, yn 

M, -H 

- 

- 

- 

- 

- 

(neg. no.) 







EXP: 

- 

- 

H 

0 

- 


POW: 

- 

- 

H 

0 

- 

- 

(neg.)**(non- 

M, 0 

- 

- 

- 

- 

- 

int.), 0**0 







LOG: 







log(0): 

- 

M, -H 

- 

- 

- 

- 

log(neg.): 

M, -H 

- 

- 

- 

- 

- 

SQRT: 

M, 0 

- 

- 

- 

- 

- 

GAMMA: 

- 

M, H 

- 

- 

- 

- 

HYPOT: 

- 

- 

H 

- 

- 

- 

SINH, COSH: 

- 

- 

H 

- 

- 

- 

SIN, COS: 

- 

- 

- 

- 

M, 0 

M, * 

TAN: 

- 

- 

H 

- 

0 

* 

ACOS, ASIN: 

M, 0 

- 

- 

- 

- 

- 



ABBREVIATIONS 

* 

As much as possible of the value is returned. 

M 

Message is printed. 

H 

HUGE is returned. 

-H 

-HUGE is returned. 

0 

0 is returned. 
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NAME 

max, maxO, amaxO, maxi, amaxl, dmaxl - Fortran maximum-value functions 

SYNOPSIS 

integer i, j, k, 1 
real a, b, c, d 

double precision dpi, dp2, dp3 

1 = max(i, j, k) 
c = max(a, b) 
dp = max(a, b, c) 
k = maxO(i, j) 
a = amaxO(i, j, k) 
i = maxl(a, b) 
d = amaxl(a, b, c) 
dp3 = dmaxl(dpl, dp2) 

DESCRIPTION 

The maximum-value functions return the largest of their arguments (of which there may be any number). 
Max is the generic form which can be used for all data types and takes its return type from that of its argu¬ 
ments (which must all be of the same type). MaxO returns the integer form of the maximum value of its 
integer arguments; amaxO, the real form of its integer arguments; maxi , the integer form of its real argu¬ 
ments; amaxl , the real form of its real arguments; and dmaxl , the double-precision form of its double¬ 
precision arguments. 

SEE ALSO 

min(3F). 
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NAME 

mclock - return Fortran time accounting 

SYNOPSIS 

integer i 

i = mclock() 

DESCRIPTION 

Mclock returns time accounting information about the current process and its child processes. The value 
returned is the sum of the current process’s user time and the user and system times of all child processes. 

SEE ALSO 

times(2), clock(3C), system(3F). 
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NAME 

memccpy, memchr, memcmp, memcpy, memset - memory operations 

SYNOPSIS 

#include <memory h> 

char memccpy (si, s2, c, n) 
char *sl, *s2; 
int c, n; 

char *memchr (s, c, n) 
char *s; 
int c, n; 

int memcmp (si, s2, n) 
char *sl, *s2; 
int n; 

char * memcpy (si, s2, n) 
char *sl, *s2; 
int n; 

char * memset (s, c, n) 
char *s; 
int c, n; 

DESCRIPTION 

These functions operate efficiently on memory areas (arrays of characters bounded by a count, not termi¬ 
nated by a null character). They do not check for the overflow of any receiving memory area. 

Memccpy copies characters from memory area s2 into si , stopping after the first occurrence of character c 
has been copied, or after n characters have been copied, whichever comes first. It returns a pointer to the 
character after the copy of c in ,v /, or a NULL pointer if c was not found in the first n characters of s2. 

Memchr returns a pointer to the first occurrence of character c in the first n characters of memory area s , or 
a NULL pointer if c does not occur. 

Memcmp compares its arguments, looking at the first n characters only, and returns an integer less than, 
equal to, or greater than 0, according as si is lexicographically less than, equal to, or greater than s2. 

Memcpy copies n characters from memory area s2 to si . It returns si. 

Memset sets the first n characters in memory area s to the value of character c. It returns s . 

NOTE 

For user convenience, all these functions are declared in the optional <memory.h> header file. 

BUGS 

Memcmp uses native character comparison, which is signed on PDP-1 Is, unsigned on other machines. 

Character movement is performed differently in different implementations. Thus overlapping moves may 
yield surprises. 
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NAME 

min, minO, aminO, mini, aminl, dminl - Fortran minimum-value functions 

SYNOPSIS 

integer i, j, k, 1 
real a, b, c, d 

double precision dpi, dp2, dp3 

1 = min(i, j, k) 
c = min(a, b) 
dp = min(a, b, c) 
k = minO(i, j) 
a = aminO(i, j, k) 
i = minl(a, b) 
d = aminl(a, b, c) 
dp3 = dminl(dpl, dp2) 

DESCRIPTION 

The minimum-value functions return the minimum of their arguments (of which there may be any number). 
Min is the generic form which can be used for all data types and takes its return type from that of its argu¬ 
ments (which must all be of the same type). MinO returns the integer form of the minimum value of its 
integer arguments; aminO, the real form of its integer arguments; mini, the integer form of its real argu¬ 
ments; aminl, the real form of its real arguments; and dminl, the double-precision form of its double¬ 
precision arguments. 

SEE ALSO 

max(3F). 
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NAME 

mktemp - make a unique file name 
SYNOPSIS 

char * mktemp (template) 
char ^template; 

DESCRIPTION 

Mktemp replaces the contents of the string pointed to by template by a unique file name, and returns the 
address of template. The string in template should look like a file name with six trailing Xs; mktemp will 
replace the Xs with a letter and the current process ID. The letter will be chosen so that the resulting name 
does not duplicate an existing file. 

SEE ALSO 

getpid(2), tmpfile(3S), tmpnam(3S). 

BUGS 

It is possible to run out of letters. 
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NAME 

mod, amod, dmod - Fortran remaindering intrinsic functions 

SYNOPSIS 

integer i, j, k 
real rl, r2, r3 

double precision dpi, dp2, dp3 

k = mod(i, j) 

r3 = amod(rl, r2) 
r3 = mod(rl, r2) 

dp3 = dmod(dpl, dp2) 
dp3 = mod(dpl, dp2) 

DESCRIPTION 

Mod returns the integer remainder of its first argument divided by its second argument. Amod and dmod 
return, respectively, the real and double-precision whole number remainder of the integer division of their 
two arguments. The generic version mod will return the data type of its arguments. 
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NAME 

monitor - prepare execution profile 
SYNOPSIS 

void monitor (lowpc, highpc, buffer, bufsize, nfunc) 
int (*lowpc)(), (*highpc)(); 
short ^buffer; 
int bufsize, nfunc; 

DESCRIPTION 

An executable program created by cc -p automatically includes calls for monitor with default parameters; 
monitor needn’t be called explicitly except to gain fine control over profiling. 

Monitor is an interface to profil{ 2). Lowpc and highpc are the addresses of two functions; buffer is the 
address of a (user supplied) array of bufsize short integers. Monitor arranges to record a histogram of peri¬ 
odically sampled values of the program counter, and of counts of calls of certain functions, in the buffer. 
The lowest address sampled is that of lowpc and the highest is just below highpc. Lowpc may not equal 0 
for this use of monitor. At most nfunc call counts can be kept; only calls of functions compiled with the 
profiling option -p of cc(l) are recorded. (The C Library and Math Library supplied when cc -p is used 
also have call counts recorded.) For the results to be significant, especially where there are small, heavily 
used routines, it is suggested that the buffer be no more than a few times smaller than the range of locations 
sampled. 

To profile the entire program, it is sufficient to use 
extern etext; 

monitor ((int (*)())2, etext, buf, bufsize, nfunc); 

Etext lies just above all the program text; see end( 3C). 

To stop execution monitoring and write the results on the file mon.out, use 
monitor ((int (*)())NULL, 0, 0, 0, 0); 

Prof( 1) can then be used to examine the results. 

FILES 

mon.out 
SEE ALSO 

cc(l), prof(l), profil(2), end(3C). 
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NAME 

nlist - get entries from name list 

SYNOPSIS 

#include <a.out h> 

int nlist (file-name, nl) 
char *file-name; 
struct nlist *nl[ ]; 

DESCRIPTION 

Nlist examines the name list in the executable file whose name is pointed to by file-name, and selectively 
extracts a list of values and puts them in the array of nlist structures pointed to by nl. The name list nl con¬ 
sists of an array of structures containing names of variables, types and values. The list is terminated with a 
null name; that is, a null string is in the name position of the structure. Each variable name is looked up in 
the name list of the file. If the name is found, the type and value of the name are inserted in the next two 
fields. If the name is not found, both entries are set to 0. See a.out( 4) for a discussion of the symbol table 
structure. 

This subroutine is useful for examining the system name list kept in the file /unix. In this way programs 
can obtain system addresses that are up to date. 

SEE ALSO 

a.out(4). 

DIAGNOSTICS 

All type entries are set to 0 if the file cannot be read or if it doesn’t contain a valid name list. 

Nlist returns -1 upon error; otherwise it returns 0. 
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NAME 

perror, errno, sys enlist, sys nen - system error messages 

SYNOPSIS 

void perror (s) 
char *s; 

extern int errno; 
extern char *sys errlist[ ]; 
extern int sys nerr; 

DESCRIPTION 

Perror produces a message on the standard error output, describing the last error encountered during a call 
to a system or library function. The argument string ,v is printed first, then a colon and a blank, then the 
message and a new-line. To be of most use, the argument string should include the name of the program 
that incurred the error. The error number is taken from the external variable errno , which is set when errors 
occur but not cleared when non-erroneous calls are made. 

To simplify variant formatting of messages, the array of message strings sys errlist is provided; errno can 
be used as an index in this table to get the message string without the new-line. Sysjierr is the largest mes¬ 
sage number provided for in the table; it should be checked because new error codes may be added to the 
system before they are added to the table. 

SEE ALSO 

intro(2). 
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NAME 

plot - graphics interface subroutines 

SYNOPSIS 

openpl () 

erase () 

label (s) 
char *s; 

line (xl, yl, x2, y2) 
int xl, yl, x2, y2; 

circle (x, y, r) 
int x, y, r; 

arc (x, y, xO, yO, xl, yl) 
int x, y, xO, yO, xl, yl; 

move (x, y) 
int x, y; 

cont (x, y) 
int x, y; 

point (x, y) 
int x, y; 

linemod (s) 
char *s; 

space (xO, yO, xl, yl) 
int xO, yO, xl, yl; 

closepl () 

DESCRIPTION 

These subroutines generate graphic output in a relatively device-independent manner. Space must be used 
before any of these functions to declare the amount of space necessary. See plot{ 4). Openpl must be used 
before any of the others to open the device for writing. Closepl flushes the output. 

Circle draws a circle of radius r with center at the point (x, y). 

Arc draws an arc of a circle with center at the point (x, y) between the points (xO, yO) and (xl, yl). 

String arguments to label and linemod are terminated by nulls and do not contain new-lines. 

See plot(A) for a description of the effect of the remaining functions. 

The library files listed below provide several flavors of these routines. 

FILES 

/usr/lib/libplot.a produces output for 1plot( 1G) filters 
/usr/lib/lib300.a for DASI 300 
/usr/lib/lib300s.a for DASI 300s 
/usr/lib/lib450.a for DASI 450 
/usr/lib/lib4014.a for Tektronix 4014 

WARNINGS 

In order to compile a program containing these functions in file.c it is necessary to use “cc file.c -lplot”. 

In order to execute it, it is necessary to use “a.out I tplot”. 

The above routines use <stdio h>, which causes them to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 
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SEE ALSO 

graph(lG), stat(lG), tplot(lG), plot(4). 


Page 2 



POPEN(3S) 


POPEN(3S) 


NAME 

popen, pclose - initiate pipe to/from a process 

SYNOPSIS 

#include <stdio h> 

FILE popen (command, type) 
char command, *type; 

int pclose (stream) 

FILE * stream; 

DESCRIPTION 

The arguments to popen are pointers to null-terminated strings containing, respectively, a shell command 
line and an I/O mode, either r for reading or w for writing. Popen creates a pipe between the calling pro¬ 
gram and the command to be executed. The value returned is a stream pointer such that one can write to 
the standard input of the command, if the I/O mode is w, by writing to the file stream ; and one can read 
from the standard output of the command, if the I/O mode is r, by reading from the file stream. 

A stream opened by popen should be closed by pclose , which waits for the associated process to terminate 
and returns the exit status of the command. 

Because open files are shared, a type r command may be used as an input filter and a type w as an output 
filter. 

SEE ALSO 

pipe(2), wait(2), fclose(3S), fopen(3S), system(3S). 

DIAGNOSTICS 

Popen returns a NULL pointer if files or processes cannot be created, or if the shell cannot be accessed. 
Pclose returns -1 if stream is not associated with a “popen ed” command. 

BUGS 

If the original and ‘ ‘ popen ed’' processes concurrently read or write a common file, neither should use buf¬ 
fered I/O, because the buffering gets all mixed up. Problems with an output filter may be forestalled by 
careful buffer flushing, e.g. with/flush; see /close (3S). 
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NAME 

printf, fprintf, sprintf - print formatted output 

SYNOPSIS 

#include <stdio h> 

int printf (format [, arg ]... ) 
char *format; 

int fprintf (stream, format [, arg ]... ) 

FILE * stream; 
char *format; 

int sprintf (s, format [, arg ]... ) 
char *s, format; 

DESCRIPTION 

Printf places output on the standard output stream stdout. Fprintf places output on the named output 
stream. Sprintf places “output”, followed by the null character (\0) in consecutive bytes starting at *s\ it is 
the user’s responsibility to ensure that enough storage is available. Each function returns the number of 
characters transmitted (not including the \0 in the case of sprintf ), or a negative value if an output error was 
encountered. 

Each of these functions converts, formats, and prints its arg s under control of the format. The format is a 
character string that contains two types of objects: plain characters, which are simply copied to the output 
stream, and conversion specifications, each of which results in fetching of zero or more arg s. The results 
are undefined if there are insufficient arg s for the format. If the format is exhausted while arg s remain, the 
excess arg s are simply ignored. 

Each conversion specification is introduced by the character %. After the %, the following appear in 
sequence: 

Zero or mor e flags, which modify the meaning of the conversion specification. 

An optional decimal digit string specifying a minimum field width. If the converted value has 
fewer characters than the field width, it will be padded on the left (or right, if the left-adjustment 
flag (see below) has been given) to the field width; 

A precision that gives the minimum number of digits to appear for the d, o, u, x, or X conver¬ 
sions, the number of digits to appear after the decimal point for the e and f conversions, the maxi¬ 
mum number of significant digits for the g conversion, or the maximum number of characters to be 
printed from a string in s conversion. The precision takes the form of a period (.) followed by a 
decimal digit string: a null digit string is treated as zero. 

An optional 1 specifying that a following d, o, u, x, or X conversion character applies to a long 
integer arg. 

A character that indicates the type of conversion to be applied. 

A field width or precision may be indicated by an asterisk (*) instead of a digit string. In this case, an inte¬ 
ger arg supplies the field width or precision. The arg that is actually converted is not fetched until the con¬ 
version letter is seen, so the arg s specifying field width or precision must appear before the arg (if any) to 
be converted. 

The flag characters and their meanings are: 

- The result of the conversion will be left-justified within the field. 

+ The result of a signed conversion will always begin with a sign (+ or -). 

blank If the first character of a signed conversion is not a sign, a blank will be prefixed to the result. 

This implies that if the blank and + flags both appear, the blank flag will be ignored. 

# This flag specifies that the value is to be converted to an “alternate form.” For c, d, s, and u 

conversions, the flag has no effect. For o conversion, it increases the precision to force the first 
digit of the result to be a zero. For x (X) conversion, a non-zero result will have Ox (OX) 
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prefixed to it. For e, E, f, g, and G conversions, the result will always contain a decimal point, 
even if no digits follow the point (normally, a decimal point appears in the result of these con¬ 
versions only if a digit follows it). For g and G conversions, trailing zeroes will not be 
removed from the result (which they normally are). 

The conversion characters and their meanings are: 

d, o,u,x,X The integer arg is converted to signed decimal, unsigned octal, decimal, or hexadecimal nota¬ 

tion (x and X), respectively; the letters abcdef are used for x conversion and the letters 
ABCDEF for X conversion. The precision specifies the minimum number of digits to appear; if 
the value being converted can be represented in fewer digits, it will be expanded with leading 
zeroes. The default precision is 1. The result of converting a zero value with a precision of 
zero is a null string. 

f The float or double arg is converted to decimal notation in the style “[-]ddd.ddd”, where the 

number of digits after the decimal point is equal to the precision specification. If the precision 
is missing, 6 digits are output; if the precision is explicitly 0, no decimal point appears. 

e, E The float or double arg is converted in the style “[-]d.ddde±dd”, where there is one digit 

before the decimal point and the number of digits after it is equal to the precision; when the 
precision is missing, 6 digits are produced; if the precision is zero, no decimal point appears. 
The E format code will produce a number with E instead of e introducing the exponent. The 
exponent always contains at least two digits. 

g,G The float or double arg is printed in style f or e (or in style E in the case of a G format code), 

with the precision specifying the number of significant digits. The style used depends on the 
value converted: style e will be used only if the exponent resulting from the conversion is less 
than -4 or greater than the precision. Trailing zeroes are removed from the result; a decimal 
point appears only if it is followed by a digit, 
c The character arg is printed. 

s The arg is taken to be a string (character pointer) and characters from the string are printed 

until a null character (\ 0 ) is encountered or the number of characters indicated by the precision 
specification is reached. If the precision is missing, it is taken to be infinite, so all characters 
up to the first null character are printed. If the string pointer arg has the value zero, the result 
is undefined. A null arg will yield undefined results. 

% Print a %; no argument is converted. 

In no case does a non-existent or small field width cause truncation of a field; if the result of a conversion is 
wider than the field width, the field is simply expanded to contain the conversion result. Characters gener¬ 
ated by printf and fprintf are printed as if putc{ 3S) had been called. 

EXAMPLES 

To print a date and time in the form “Sunday, July 3, 10:02”, where weekday and month are pointers to 
null-terminated strings: 

printf("%s, %s %d, %.2d:%.2d", weekday, month, day, hour, min); 

To print 7t to 5 decimal places: 

printffpi = %.5f", 4*atan(1.0)); 

SEE ALSO 

ecvt(3C), putc(3S), scanf(3S), stdio(3S). 
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NAME 

putc, putchar, fputc, putw - put character or word on a stream 

SYNOPSIS 

#include <stdio h> 

int putc (c, stream) 
char c; 

FILE * stream; 

int putchar (c) 
char c; 

int fputc (c, stream) 
char c; 

FILE * stream; 

int putw (w, stream) 
int w; 

FILE * stream; 

DESCRIPTION 

Putc writes the character c onto the output stream (at the position where the hie pointer, if defined, is 
pointing). Putchar(c) is defined as putc(c, stdout). Putc and putchar are macros. 

Fputc behaves like putc, but is a function rather than a macro. Fputc runs more slowly than putc, but takes 
less space per invocation. 

Putw writes the word (i.e. integer) w to the output stream (at the position at which the hie pointer, if 
defined, is pointing). The size of a word is the size of an integer and varies from machine to machine. 
Putw neither assumes nor causes special alignment in the hie. 

Output streams, with the exception of the standard error stream stderr, are by default buffered if the output 
refers to a hie and line-buffered if the output refers to a terminal. The standard error output stream stderr is 
by default unbuffered, but use of freopen (see fopen (3S)) will cause it to become buffered or line-buffered. 
When an output stream is unbuffered information is queued for writing on the destination hie or terminal as 
soon as written; when it is buffered many characters are saved up and written as a block; when it is line- 
buffered each line of output is queued for writing on the destination terminal as soon as the line is com¬ 
pleted (that is, as soon as a new-line character is written or terminal input is requested). Setbuf{ 3S) may be 
used to change the stream’s buffering strategy. 

SEE ALSO 

fclose(3S), ferror(3S), fopen(3S), fread(3S), printf(3S), puts(3S), setbuf(3S). 

DIAGNOSTICS 

On success, these functions each return the value they have written. On failure, they return the constant 
EOF. This will occur if the hie stream is not open for writing, or if the output hie cannot be grown. 
Because EOF is a valid integer, /error (3S) should be used to detect putw errors. 

BUGS 

Because it is implemented as a macro, putc treats incorrectly a stream argument with side effects. In par¬ 
ticular, putc(c, *f++); doesn’t work sensibly. Fputc should be used instead. 

Because of possible differences in word length and byte ordering, hies written using putw are machine- 
dependent, and may not be read using getw on a different processor. For this reason the use of putw should 
be avoided. 
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NAME 

putpwent - write password file entry 

SYNOPSIS 

#include <pwd h> 

int putpwent (p, f) 
struct passwd *p; 

FILE *f; 

DESCRIPTION 

Putpwent is the inverse of getpwent{ 3C). Given a pointer to a passwd structure created by getpwent (or 
getpwuid or getpwnam), putpwuid writes a line on the stream/which matches the format of /etc/passwd. 

DIAGNOSTICS 

Putpwent returns non-zero if an error was detected during its operation, otherwise zero. 

WARNING 

The above routine uses <stdio h>, which causes it to increase the size of programs, not otherwise using 
standard I/O, more than might be expected. 
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NAME 

puts, fputs - put a string on a stream 

SYNOPSIS 

#include <stdio h> 

int puts (s) 
char *s; 

int fputs (s, stream) 
char *s; 

FILE * stream; 

DESCRIPTION 

Puts writes the null-terminated string pointed to by s, followed by a new-line character, to the standard out¬ 
put stream stdout. 

Fputs writes the null-terminated string pointed to by s to the named output stream. 

Neither function writes the terminating null character. 

DIAGNOSTICS 

Both routines return EOF on error. This will happen if the routines try to write on a file that has not been 
opened for writing. 

SEE ALSO 

ferror(3S), fopen(3S), fread(3S), printf(3S), putc(3S). 

NOTES 

Puts appends a new-line character while fputs does not. 
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NAME 

qsort - quicker sort 
SYNOPSIS 

void qsort ((char *) base, nel, sizeof (*base), compar) 
unsigned int nel; 
int (*compar)(); 

DESCRIPTION 

Qsort is an implementation of the quicker-sort algorithm. It sorts a table of data in place. 

Base points to the element at the base of the table. Nel is the number of elements in the table. Compar is 
the name of the comparison function, which is called with two arguments that point to the elements being 
compared. The function must return an integer less than, equal to, or greater than zero according as the first 
argument is to be considered less than, equal to, or greater than the second. 

NOTES 

The pointer to the base of the table should be of type pointer-to-element, and cast to type pointer-to- 
character. 

The comparison function need not compare every byte, so arbitrary data may be contained in the elements 
in addition to the values being compared. 

Although declared as type pointer-to-character, the value returned should be cast into type pointer-to- 
element. 

SEE ALSO 

sort(l), bsearch(3C), lsearch(3C), string(3C). 
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NAME 

rand, srand - simple random-number generator 

SYNOPSIS 

int rand () 

void srand (seed) 
unsigned seed; 

DESCRIPTION 

32 

Rand uses a multiplicative congruential random-number generator with period 2 that returns successive 
pseudo-random numbers in the range from 0 to 2 15 -1. 

Srand can be called at any time to reset the random-number generator to a random starting point. The gen¬ 
erator is initially seeded with a value of 1. 

NOTE 

The spectral properties of rand leave a great deal to be desired. Drand48{ 3C) provides a much better, 
though more elaborate, random-number generator. 

SEE ALSO 

drand48(3C). 
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NAME 

srand, rand - Fortran uniform random-number generator 

SYNOPSIS 

integer i, j 

call srand(i) 
j = rand() 

DESCRIPTION 

Srand takes its integer argument as the seed of a random-number generator, the values of which are 
returned through successive invocations of rand. 

SEE ALSO 

rand(3C). 
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NAME 

regcmp, regex - compile and execute regular expression 

SYNOPSIS 

char *regcmp(stringl [, string2,...], 0) 
char string 1, *string2,.. 

char *regex(re, subject[, retO,...]) 
char re, subject, * retO,.. 

extern char *locl; 

DESCRIPTION 

Regcmp compiles a regular expression and returns a pointer to the compiled form. Malloc( 3C) is used to 
create space for the vector. It is the user’s responsibility to free unneeded space so allocated. A NULL 
return from regcmp indicates an incorrect argument. Regcmp ( 1) has been written to generally preclude the 
need for this routine at execution time. 

Regex executes a compiled pattern against the subject string. Additional arguments are passed to receive 
values back. Regex returns NULL on failure or a pointer to the next unmatched character on success. A 
global character pointer loci points to where the match began. Regcmp and regex were mostly borrowed 
from the editor, ed( 1); however, the syntax and semantics have been changed slightly. The following are 
the valid symbols and their associated meanings. 

[]*.'' These symbols retain their current meaning. 

$ Matches the end of the string, \n matches the new-line. 

- Within brackets the minus means through. For example, [a-z] is equivalent to [abcd...xyz]. 

The - can appear as itself only if used as the last or first character. For example, the character 
class expression []-] matches the characters ] and -. 

+ A regular expression followed by + means one or more times. For example, [0-9]+ is equivalent 

to [0-9] [0-9]*. 

[m] {m,} [m,u] 

Integer values enclosed in {} indicate the number of times the preceding regular expression is to 
be applied, m is the minimum number and u is a number, less than 256, which is the maximum. 
If only m is present (e.g., {m}), it indicates the exact number of times the regular expression is to 
be applied, {m,} is analogous to {m,infinity}. The plus (+) and star (*) operations are equivalent 
to {1,} and {0,} respectively. 

(... )$« The value of the enclosed regular expression is to be returned. The value will be stored in the 
(n+1 )th argument following the subject argument. At present, at most ten enclosed regular 
expressions are allowed. Regex makes its assignments unconditionally. 

(...) Parentheses are used for grouping. An operator, e.g. *, +, {}, can work on a single character or a 
regular expression enclosed in parenthesis. For example, (a*(cb+)*)$0. 

By necessity, all the above defined symbols are special. They must, therefore, be escaped to be used as 
themselves. 

EXAMPLES 

Example 1: 

char *cursor, *newcursor, *ptr; 

newcursor = regex((ptr = regcmp(""\n", 0)), cursor); 
free(ptr); 

This example will match a leading new-line in the subject string pointed at by cursor. 

Example 2: 

charret0[9]; 
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char *newcursor, *name; 

name = regcmp("([A-Za-z][A-za-z0-9_]{0,7})$0", 0); 
newcursor = regex(name, "123Testing321", retO); 

This example will match through the string “Testing3” and will return the address of the character after the 
last matched character (cursor+11). The string “Testing3” will be copied to the character array retO. 

Example 3: 

#include "file.i" 

char ^string, * newcursor; 

newcursor = regex(name, string); 

This example applies a precompiled regular expression in file i (see regcmp{ 1)) against string. 

This routine is kept in /Iib/IibPW.a. 

SEE ALSO 

ed(l), regcmp(l), malloc(3C). 

BUGS 

The user program may run out of memory if regcmp is called iteratively without freeing the vectors no 
longer required. The following user-supplied replacement for malloc{ 3C) reuses the same vector saving 
time and space: 

/* user’s program *■/ 

malloc(n) { 

static int rebuf[256]; 
return rebuf; 

} 
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NAME 

anint, dnint, nint, idnint - Fortran nearest integer functions 

SYNOPSIS 

integer i 
real rl, r2 

double precision dpi, dp2 

r2 = anint(rl) 
i = nint(rl) 

dp2 = anint(dpl) 
dp2 = dnint(dpl) 

i = nint(dpl) 
i = idnint(dpl) 

DESCRIPTION 

Anint returns the nearest whole real number to its real argument (i.e., int(a+0.5) if a > 0, int(a-0.5) other¬ 
wise). Dnint does the same for its double-precision argment. Nint returns the nearest integer to its real 
argument. Idnint is the double-precision version. Anint is the generic form of anint and dnint, performing 
the same operation and returning the data type of its argument. Nint is also the generic form of idnint. 
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NAME 

scanf, fscanf, sscanf - convert formatted input 

SYNOPSIS 

#include <stdio h> 

int scanf (format [, pointer ]... ) 
char *format; 

int fscanf (stream, format [ , pointer ]... ) 

FILE * stream; 
char *format; 

int sscanf (s, format [, pointer ] ... ) 
char *s, ^format; 

DESCRIPTION 

Scanf reads from the standard input stream stdin. Fscanf reads from the named input stream. Sscanf reads 
from the character string s. Each function reads characters, interprets them according to a format, and 
stores the results in its arguments. Each expects, as arguments, a control string format described below, 
and a set of pointer arguments indicating where the converted input should be stored. 

The control string usually contains conversion specifications, which are used to direct interpretation of 
input sequences. The control string may contain: 

1. White-space characters (blanks, tabs, new-lines, or form-feeds) which, except in two cases described 
below, cause input to be read up to the next non-white-space character. 

2. An ordinary character (not %), which must match the next character of the input stream. 

3. Conversion specifications, consisting of the character %, an optional assignment suppressing character 
*, an optional numerical maximum field width, an optional 1 or h indicating the size of the receiving 
variable, and a conversion code. 

A conversion specification directs the conversion of the next input field; the result is placed in the variable 
pointed to by the corresponding argument, unless assignment suppression was indicated by *. The suppres¬ 
sion of assignment provides a way of describing an input field which is to be skipped. An input field is 
defined as a string of non-space characters; it extends to the next inappropriate character or until the field 
width, if specified, is exhausted. 

The conversion code indicates the interpretation of the input field; the corresponding pointer argument must 
usually be of a restricted type. For a suppressed field, no pointer argument should be given. The following 
conversion codes are legal: 

% a single % is expected in the input at this point; no assignment is done, 

d a decimal integer is expected; the corresponding argument should be an integer pointer, 

u an unsigned decimal integer is expected; the corresponding argument should be an unsigned inte¬ 

ger pointer. 

o an octal integer is expected; the corresponding argument should be an integer pointer, 

x a hexadecimal integer is expected; the corresponding argument should be an integer pointer. 

e,f,g a floating point number is expected; the next field is converted accordingly and stored through the 

corresponding argument, which should be a pointer to a float. The input format for floating point 
numbers is an optionally signed string of digits, possibly containing a decimal point, followed by 
an optional exponent field consisting of an E or an e, followed by an optionally signed integer, 
s a character string is expected; the corresponding argument should be a character pointer pointing 

to an array of characters large enough to accept the string and a terminating \0, which will be 
added automatically. The input field is terminated by a white-space character, 
c a character is expected; the corresponding argument should be a character pointer. The normal 

skip over white space is suppressed in this case; to read the next non-space character, use % Is. If 
a field width is given, the corresponding argument should refer to a character array; the indicated 
number of characters is read. 
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[ indicates string data and the normal skip over leading white space is suppressed. The left bracket 

is followed by a set of characters, which we will call the scanset, and a right bracket; the input 
field is the maximal sequence of input characters consisting entirely of characters in the scanset. 
The circumflex, ('), when it appears as the first character in the scanset, serves as a complement 
operator and redefines the scanset as the set of all characters not contained in the remainder of the 
scanset string. There are some conventions used in the construction of the scanset. A range of 
characters may be represented by the construct first-last, thus [0123456789] may be expressed [0- 
9]. Using this convention, first must be lexically less than or equal to last, or else the dash will 
stand for itself. The dash will also stand for itself whenever it is the first or the last character in the 
scanset. To include the right square bracket as an element of the scanset, it must appear as the first 
character (possibly preceded by a circumflex) of the scanset, and in this case it will not be syntacti¬ 
cally interpreted as the closing bracket. The corresponding argument must point to a character 
array large enough to hold the data field and the terminating \0, which will be added automatically. 

The conversion characters d, u, o, and x may be preceded by 1 or h to indicate that a pointer to long or to 
short rather than to int is in the argument list. Similarly, the conversion characters e , f , and g may be pre¬ 
ceded by 1 to indicate that a pointer to double rather than to float is in the argument list. 

Scanf conversion terminates at EOF, at the end of the control string, or when an input character conflicts 
with the control string. In the latter case, the offending character is left unread in the input stream. 

Scanf returns the number of successfully matched and assigned input items; this number can be zero in the 
event of an early conflict between an input character and the control string. If the input ends before the first 
conflict or conversion, EOF is returned. 

EXAMPLES 

The call: 

int i; float x; char name[50]; 
scanf ("%d%f%s", &i, &x, name); 

with the input line: 

25 54.32E-1 thompson 

will assign to i the value 25, to x the value 5.432, and name will contain thompson\0. Or: 

int i; float x; char name[50]; 

scanf ("%2d%f%*d%[0-9]", &i, &x, name); 

with input: 

56789 0123 56a72 

will assign 56 to i, 789.0 to x, skip 0123, and place the string 56\0 in name. The next call to getchar (see 
getc( 3S)) will return a. 

SEE ALSO 

atof(3C), getc(3S), printf(3S), strtol(3C). 

NOTE 

Trailing white space (including a new-line) is left unread unless matched in the control string. 
DIAGNOSTICS 

These functions return EOF on end of input and a short count for missing or illegal data items. 

BUGS 

The success of literal matches and suppressed assignments is not directly determinable. 
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NAME 

setbuf - assign buffering to a stream 

SYNOPSIS 

#include <stdio h> 

void setbuf (stream, buf) 

FILE * stream; 
char *buf; 

DESCRIPTION 

Setbuf is used after a stream has been opened but before it is read or written. It causes the character array 
pointed to by buf to be used instead of an automatically allocated buffer. If buf is a NULL character pointer 
input/output will be completely unbuffered. 

A constant BUFSIZ, defined in the <stdio h> header file, tells how big an array is needed: 
char buf [BUFSIZ]; 

A buffer is normally obtained from malloc{ 3C) at the time of the first getc or putc( 3S) on the file, except 
that the standard error stream stderr is normally not buffered. 

Output streams directed to terminals are always line-buffered unless they are unbuffered. 

SEE ALSO 

fopen(3S), getc(3S), malloc(3C), putc(3S). 

NOTE 

A common source of error is allocating buffer space as an “automatic” variable in a code block, and then 
failing to close the stream in the same block. 
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NAME 

setjmp, longjmp - non-local goto 

SYNOPSIS 

#include <setjmp.h> 

int setjmp (env) 
jmpbuf env; 

void longjmp (env, val) 
jmp buf env; 
int val; 

DESCRIPTION 

These functions are useful for dealing with errors and interrupts encountered in a low-level subroutine of a 
program. 

Setjmp saves its stack environment in env (whose type,, jmp buf, is defined in the <setjmp.h> header file), 
for later use by longjmp. It returns the value 0. 

Longjmp restores the environment saved by the last call of setjmp with the corresponding env argument. 
After longjmp is completed program execution continues as if the corresponding call of setjmp (which must 
not itself have returned in the interim) had just returned the value val. Longjmp cannot cause setjmp to 
return the value 0. If longjmp is invoked with a second argument of 0, setjmp will return 1. All accessible 
data have values as of the time longjmp was called. 

SEE ALSO 

signal(2). 

WARNING 

If longjmp is called when env was never primed by a call to setjmp, or when the last such call is in a func¬ 
tion which has since returned, absolute chaos is guaranteed. 
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NAME 

sign, isign, dsign - Fortran transfer-of-sign intrinsic function 

SYNOPSIS 

integer i, j, k 
real rl, r2, r3 

double precision dpi, dp2, dp3 

k = isign(i, j) 
k = sign(i, j) 

r3 = sign(rl, r2) 

dp3 = dsign(dpl, dp2) 
dp3 = sign(dpl, dp2) 

DESCRIPTION 

Isign returns the magnitude of its first argument with the sign of its second argument. Sign and dsign are 
its real and double-precision counterparts, respectively. The generic version is sign and will devolve to the 
appropriate type depending on its arguments. 
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NAME 

signal - specify Fortran action on receipt of a system signal 

SYNOPSIS 

integer i 

external integer intfnc 
call signal(i, intfnc) 

DESCRIPTION 

Signal allows a process to specify a function to be invoked upon receipt of a specific signal. The first argu¬ 
ment specifies which fault or exception, the second argument the function to be invoked. 

SEE ALSO 

kill(2), signal(2). 
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NAME 

sin, dsin, csin - Fortran sine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = sin(rl) 

dp2 = dsin(dpl) 
dp2 = sin(dpl) 

cx2 = csin(cxl) 
cx2 = sin(cxl) 

DESCRIPTION 

Sin returns the real sine of its real argument. Dsin returns the double-precision sine of its double-precision 
argument. Csin returns the complex sine of its complex arguemnt. The generic sin function becomes dsin 
or csin as required by argument type. 

SEE ALSO 

trig(3M). 


Page 1 



SINH(3F) 


SINH(3F) 


NAME 

sinh, dsinh - Fortran hyperbolic sine intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = sinh(rl) 

dp2 = dsinh(dpl) 
dp2 = sinh(dpl) 

DESCRIPTION 

Sinh returns the real hyperbolic sine of its real argument. Dsinh returns the double-precision hyperbolic 
sine of its double-precision argument. The generic form sinh may be used to return a double-precision 
value given a double-precision argument. 

SEE ALSO 

sinh(3M). 
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NAME 

sinh, cosh, tanh - hyperbolic functions 

SYNOPSIS 

#include <math.h> 

double sinh (x) 
double x; 

double cosh (x) 
double x; 

double tanh (x) 
double x; 

DESCRIPTION 

Sinh, cosh and tanh return respectively the hyberbolic sine, cosine and tangent of their argument. 
DIAGNOSTICS 

Sinh and cosh return HUGE when the correct value would overflow, and set errno to ERANGE. 

These error-handling procedures may be changed with the function matherr( 3M). 

SEE ALSO 

matherr(3M). 
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NAME 

sleep - suspend execution for interval 
SYNOPSIS 

unsigned sleep (seconds) 
unsigned seconds; 

DESCRIPTION 

The current process is suspended from execution for the number of seconds specified by the argument. The 
actual suspension time may be less than that requested for two reasons: (1) Because scheduled wakeups 
occur at fixed 1-second intervals, (on the second, according to an internal clock) and (2) because any caught 
signal will terminate the sleep following execution of that signal’s catching routine. Also, the suspension 
time may be longer than requested by an arbitrary amount due to the scheduling of other activity in the sys¬ 
tem. The value returned by sleep will be the ‘ ‘unslept’ ’ amount (the requested time minus the time actually 
slept) in case the caller had an alarm set to go off earlier than the end of the requested sleep time, or prema¬ 
ture arousal due to another caught signal. 

The routine is implemented by setting an alarm signal and pausing until it (or some other signal) occurs. 
The previous state of the alarm signal is saved and restored. The calling program may have set up an alarm 
signal before calling sleep ; if the sleep time exceeds the time till such alarm signal, the process sleeps only 
until the alarm signal would have occurred, and the caller’s alarm catch routine is executed just before the 
sleep routine returns, but if the sleep time is less than the time till such alarm, the prior alarm time is reset 
to go off at the same time it would have without the intervening sleep. 

SEE ALSO 

alarm(2), pause(2), signal(2). 
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SPUTL(3X) 


NAME 

sputl, sgetl - access long numeric data in a machine independent fashion. 

SYNOPSIS 

sputl ( value, buffer ) 
long value; 
char *buffer; 

long sgetl ( buffer ) 
char *buffer; 

DESCRIPTION 

Sputl ( 3X) will take the 4 bytes of the long value and place them in memory starting at the address pointed 
to by buffer. The ordering of the bytes is the same across all machines. Sgetl will retrieve the 4 bytes in 
memory starting at the address pointed to by buffer and return the long value in the byte ordering of the 
host machine. 

The usage of sputl ( 3X) and sgetl in combination provides a machine independent way of storing long 
numeric data in an ASCII file. The numeric data stored in the portable archive file format (see ar( 4)) is 
written and read into/from buffers with sputl (3X) and sgetl respectively. 

A program which uses these functions must be loaded with the object file access routine library Iibld.a. 

SEE ALSO 

ar(4). 
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NAME 

sqrt, dsqrt, csqrt - Fortran square root intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 
complex cxl, cx2 

r2 = sqrt(rl) 

dp2 = dsqrt(dpl) 
dp2 = sqrt(dpl) 

cx2 = csqrt(cxl) 
cx2 = sqrt(cxl) 

DESCRIPTION 

Sqrt returns the real square root of its real argument. Dsqrt returns the double-precision square root of its 
double-precision arguement. Csqrt returns the complex square root of its complex argument. Sqrt, the 
generic form, will become dsqrt or csqrt as required by its argument type. 

SEE ALSO 

exp(3M). 
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NAME 

ssignal, gsignal - software signals 

SYNOPSIS 

#include <signal.h> 

int (*ssignal (sig, action))() 
int sig, (action)(); 

int gsignal (sig) 
int sig; 

DESCRIPTION 

Ssignal and gsignal implement a software facility similar to signal (2). This facility is used by the Standard 
C Library to enable users to indicate the disposition of error conditions, and is also made available to users 
for their own purposes. 

Software signals made available to users are associated with integers in the inclusive range 1 through 15. A 
call to ssignal associates a procedure, action , with the software signal sig ; the software signal, sig, is raised 
by a call to gsignal. Raising a software signal causes the action established for that signal to be taken. 

The first argument to ssignal is a number identifying the type of signal for which an action is to be estab¬ 
lished. The second argument defines the action; it is either the name of a (user defined) action function or 
one of the manifest constants SIG DFL (default) or SIG IGN (ignore). Ssignal returns the action previ¬ 
ously established for that signal type; if no action has been established or the signal number is illegal, 
ssignal returns SIG DFL. 

Gsignal raises the signal identified by its argument, sig: 

If an action function has been established for sig, then that action is reset to SIG DFL and the action 
function is entered with argument sig. Gsignal returns the value returned to it by the action function. 

If the action for sig is SIG IGN, gsignal returns the value 1 and takes no other action. 

If the action for sig is SIG DFL, gsignal returns the value 0 and takes no other action. 

If sig has an illegal value or no action was ever specified for sig, gsignal returns the value 0 and 
takes no other action. 

NOTES 

There are some additional signals with numbers outside the range 1 through 15 which are used by the Stan¬ 
dard C Library to indicate error conditions. Thus, some signal numbers outside the range 1 through 15 are 
legal, although their use may interfere with the operation of the Standard C Library. 
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NAME 

stdio - standard buffered input/output package 

SYNOPSIS 

#include <stdio h> 

FILE stdin, *stdout, *stderr; 

DESCRIPTION 

The functions described in the entries of sub-class 3S of this manual constitute an efficient, user-level I/O 
buffering scheme. The in-line macros getc( 3S) and putc( 3S) handle characters quickly. The macros 
getchar, putchar, and the higher-level routines fgetc,fgets,fprintf,fputc,fputs,fread,fscanf,fwrite, gets, 
getw, printf, puts, putw, and scanf all use getc and putc ; they can be freely intermixed. 

A file with associated buffering is called a stream and is declared to be a pointer to a defined type FILE. 
Fopen (3S) creates certain descriptive data for a stream and returns a pointer to designate the stream in all 
further transactions. Normally, there are three open streams with constant pointers declared in the 
<stdio h> header file and associated with the standard open files: 

stdin standard input file 

stdout standard output file 

stderr standard error file. 

A constant NULL (0) designates a nonexistent pointer. 

An integer constant EOF (-1) is returned upon end-of-file or error by most integer functions that deal with 
streams (see the individual descriptions for details). 

Any program that uses this package must include the header file of pertinent macro definitions, as follows: 
#include <stdio.h> 

The functions and constants mentioned in the entries of sub-class 3S of this manual are declared in that 
header file and need no further declaration. The constants and the following “functions” are implemented 
as macros (redeclaration of these names is perilous): getc, getchar, putc, putchar, feof, /error, clearerr, 
and fileno. 

SEE ALSO 

open(2), close(2), lseek(2), pipe(2), read(2), write(2), ctermid(3S), cuserid(3S), fclose(3S), ferror(3S), 
fopen(3S), fread(3S), fseek(3S), getc(3S), gets(3S), popen(3S), printf(3S), putc(3S), puts(3S), scanf(3S), 
setbuf(3S), system(3S), tmpfile(3S), tmpnam(3S), ungetc(3S). 

DIAGNOSTICS 

Invalid stream pointers will usually cause grave disorder, possibly including program termination. Individ¬ 
ual function descriptions describe the possible error conditions. 
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NAME 

stdipc - standard interprocess communication package 
SYNOPSIS 

#include <sys/types h> 

#include <sys/ipc h> 

key t ftok(path, id) 
char *path; 
char id; 

DESCRIPTION 

All interprocess communication facilities require the user to supply a key to be used by the msgget( 2), 
semgeti 2) and shmget{ 2) system calls to obtain interprocess communication identifiers. One suggested 
method for forming a key is to use th eft ok subroutine described below. Another way to compose keys is to 
include the project ID in the most significant byte and to use the remaining portion as a sequence number. 
There are many other ways to form keys, but it is necessary for each system to define standards for forming 
them. If some standard is not adhered to, it will be possible for unrelated processes to unintentionally inter¬ 
fere with each other’s operation. Therefore, it is strongly suggested that the most significant byte of a key 
in some sense refer to a project so that keys do not conflict across a given system. 

Ftok returns a key based on path and id that is usable in subsequent msgget , semget and shmget system 
calls. Path must be the path name of an existing file that is accessible to the process. Id is a character 
which uniquely identifies a project. Note that ftok will return the same key for linked files when called with 
the same id and that it will return different keys when called with the same file name but different ids. 

SEE ALSO 

intro(2), msgget(2), semget(2), shmget(2). 

DIAGNOSTICS 

Ftok returns (key t) -1 if path does not exist or if it is not accessible to the process. 

WARNING 

If the file whose path is passed to ftok is removed when keys still refer to the file, future calls to ftok with 
the same path and id will return an error. If the same file is recreated, then ftok is likely to return a different 
key than it did the original time it was called. 
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NAME 

strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, strchr, strrchr, strpbrk, strspn, strcspn, strtok - string 
operations 

SYNOPSIS 

#include <string.h> 

char *strcat (si, s2) 
char *sl, *s2; 

char strncat (si, s2, n) 
char *sl, *s2; 
int n; 

int strcmp (si, s2) 
char *sl, *s2; 

int strncmp (si, s2, n) 
char *sl, *s2; 
int n; 

char strcpy (si, s2) 
char *sl, *s2; 

char strncpy (si, s2, n) 
char *sl, *s2; 
int n; 

int strlen (s) 
char *s; 

char strchr (s, c) 
char *s, c; 

char *strrchr (s, c) 
char *s, c; 

char *strpbrk (si, s2) 
char *sl, *s2; 

int strspn (si, s2) 
char *sl, *s2; 

int strcspn (si, s2) 
char *sl, *s2; 

char strtok (si, s2) 
char *sl, *s2; 

DESCRIPTION 

The arguments si, s2 and s point to strings (arrays of characters terminated by a null character). The func¬ 
tions strcat, strncat, strcpy and strncpy all alter si. These functions do not check for overflow of the array 
pointed to by si. 

Strcat appends a copy of string s2 to the end of string si. Strncat appends at most n characters. Each 
returns a pointer to the null-terminated result. 

Strcmp compares its arguments and returns an integer less than, equal to, or greater than 0, according as si 
is lexicographically less than, equal to, or greater than s2. Strncmp makes the same comparison but looks 
at at most n characters. 

Strcpy copies string s2 to si, stopping after the null character has been copied. Strncpy copies exactly n 
characters, truncating s2 or adding null characters to si if necessary. The result will not be null-terminated 
if the length of s2 is n or more. Each function returns si. 
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Strlen returns the number of characters in s, not including the terminating null character. 

Strchr (strrchr ) returns a pointer to the first (last) occurrence of character c in string ,v, or a NULL pointer if 
c does not occur in the string. The null character terminating a string is considered to be part of the string. 

Strpbrk returns a pointer to the first occurrence in string si of any character from string s2, or a NULL 
pointer if no character from s2 exists in si. 

Strspn (strcspn ) returns the length of the initial segment of string si which consists entirely of characters 
from (not from) string s2. 

Strtok considers the string si to consist of a sequence of zero or more text tokens separated by spans of one 
or more characters from the separator string s2 . The first call (with pointer si specified) returns a pointer to 
the first character of the first token, and will have written a null character into si immediately following the 
returned token. The function keeps track of its position in the string between separate calls, so that on sub¬ 
sequent calls (which must be made with the first argument a NULL pointer) will work through the string si 
immediately following that token. In this way subsequent calls will work through the string si until no 
tokens remain. The separator string s2 may be different from call to call. When no token remains in si , a 
NULL pointer is returned. 

NOTE 

For user convenience, all these functions are declared in the optional <string.h> header file. 

BUGS 

Strcmp and strncmp use native character comparison, which is signed on PDP-lls, unsigned on other 
machines. 

Character movement is performed differently in different implementations. Thus overlapping moves may 
yield surprises. 
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NAME 

strtol, atol, atoi - convert string to integer 
SYNOPSIS 

long strtol (str, ptr, base) 
char str; 
char **ptr; 
int base; 

long atol (str) 
char str; 

int atoi (str) 
char str; 

DESCRIPTION 

Strtol returns as a long integer the value represented by the character string str. The string is scanned up to 
the first character inconsistent with the base. Leading ‘ ‘white-space’ ’ characters are ignored. 

If the value of ptr is not (char **)NULL, a pointer to the character terminating the scan is returned in ■•-ptr. 
If no integer can be formed, *ptr is set to sir , and zero is returned. 

If base is positive (and not greater than 36), it is used as the base for conversion. After an optional leading 
sign, leading zeros are ignored, and “Ox” or “OX” is ignored if base is 16. 

If base is zero, the string itself determines the base thus: After an optional leading sign, a leading zero indi¬ 
cates octal conversion, and a leading “Ox” or “OX” hexadecimal conversion. Otherwise, decimal conver¬ 
sion is used. 

Truncation from long to int can, of course, take place upon assignment, or by an explicit cast. 

Atol(str) is equivalent to strtolfstr, (char **)NULL, 10). 

Atoi(str) is equivalent to (int) strtolfstr, (char **)NULL, 10). 

SEE ALSO 

atof(3C), scanf(3S). 

BUGS 

Overflow conditions are ignored. 


Page 1 



SWAB(3C) 


SWAB(3C) 


NAME 


swab - swap bytes 


SYNOPSIS 

void swab (from, to, nbytes) 
char *from, *to; 
int nbytes; 

DESCRIPTION 

Swab copies nbytes bytes pointed to by from to the array pointed to by to, exchanging adjacent even and 
odd bytes. It is useful for carrying binary data between PDP-lls and other machines. Nbytes should be 
even and non-negative. If nbytes is odd and positive swab uses nbytes -1 instead. If nbytes is negative 
swab does nothing. 
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NAME 

system - issue a shell command from Fortran 

SYNOPSIS 

character ^ c 

call system(c) 

DESCRIPTION 

System causes its character argument to be given to sh{ 1) as input, as if the string had been typed at a termi¬ 
nal. The current process waits until the shell has completed. 

SEE ALSO 

sh(l), exec(2), system(3S). 
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NAME 

system - issue a shell command 

SYNOPSIS 

#include <stdio h> 

int system (string) 
char string; 

DESCRIPTION 

System causes the string to be given to sh{ 1) as input, as if the string had been typed as a command at a ter¬ 
minal. The current process waits until the shell has completed, then returns the exit status of the shell. 

FILES 

/bin/sh 

SEE ALSO 

sh( 1), exec(2). 

DIAGNOSTICS 

System forks to create a child process that in turn exec’s /bin/sh in order to execute string. If the fork or 
exec fails, system returns -1 and sets errno. 
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NAME 

tan, dtan - Fortran tangent intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = tan(rl) 

dp2 = dtan(dpl) 
dp2 = tan(dpl) 

DESCRIPTION 

Tan returns the real tangent of its real argument. Dtan returns the double-precision tangent of its double¬ 
precision argument. The generic tan function becomes dtan as required with a double-precision argument. 

SEE ALSO 

trig(3M). 
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NAME 

tanh, dtanh - Fortran hyperbolic tangent intrinsic function 

SYNOPSIS 

real rl, r2 

double precision dpi, dp2 

r2 = tanh(rl) 

dp2 = dtanh(dpl) 
dp2 = tanh(dpl) 

DESCRIPTION 

Tanh returns the real hyperbolic tangent of its real argument. Dtanh returns the double-precision hyper¬ 
bolic tangent of its double precision argument. The generic form tanh may be used to return a double¬ 
precision value given a double-precision argument. 

SEE ALSO 

sinh(3M). 
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(Provisional) 


TERMCAP(3) 


NAME 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal independent operation routines 

SYNOPSIS 

char PC; 
char BC; 
char *UP; 
short ospeed; 

tgetent(bp, name) 
char *bp, *name; 

tgetnum(id) 
char *id; 

tgetflag(id) 
char *id; 

char * 

tgetstr(id, area) 
char *id, **area; 

char * 

tgoto(cm, destcol, destline) 
char *cm; 

tputs(cp, affcnt, outc) 
register char *cp; 
int affcnt; 
int (*outc)(); 

DESCRIPTION 

These functions extract and use capabilities from the terminal capability data base termcap( 5). Note that 
these are low level routines. 

Tgetent extracts the entry for terminal name into the buffer at bp. Bp should be a character buffer of size 
1024 and must be retained through all subsequent calls to tgetnum, tgetflag, and tgetstr. Tgetent returns -1 
if it cannot open the termcap file, 0 if the terminal name given does not have an entry, and 1 if all goes well. 
It will look in the environment for a TERMCAP variable. If found, and the value does not begin with a 
slash, and the terminal type name is the same as the environment string TERM, the TERMCAP string is 
used instead of reading the termcap file. If it does begin with a slash, the string is used as a path name 
rather than /etc/termcap. This can speed up entry into programs that call tgetent, as well as to help debug 
new terminal descriptions or to make one for your terminal if you can’t write the file /etc/termcap. 

Tgetnum gets the numeric value of capability id, returning -1 if is not given for the terminal. Tgetflag 
returns 1 if the specified capability is present in the terminal's entry, 0 if it is not. Tgetstr gets the string 
value of capability id, placing it in the buffer at area, advancing the area pointer. It decodes the abbrevia¬ 
tions for this field described in termcapi 5), except for cursor addressing and padding information. 

Tgoto returns a cursor addressing string decoded from cm to go to column destcol in line destline. It uses 
the external variables UP (from the up capability) and BC (if be is given rather than bs) if necessary to 
avoid placing \n, ~I) or in the returned string. (Programs which call tgoto should be sure to turn off the 
XTABS bit(s), since tgoto may now output a tab. Note that programs using termcap should in general turn 
off XTABS anyway since some terminals use control I for other functions, such as nondestructive space.) 
If a % sequence is given which is not understood, then tgoto returns “OOPS”. 

Tputs decodes the leading padding information of the string cp; affcnt gives the number of lines affected by 
the operation, or 1 if this is not applicable, outc is a routine which is called with each character in turn. The 
external variable ospeed should contain the output speed of the terminal as encoded by stty (2). The external 
variable PC should contain a pad character to be used (from the pc capability) if a null (*@) is inappropri¬ 
ate. 
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FILES 

/usr/lib/libtermcap.a -ltermcap library 
/etc/termcap data base 

SEE ALSO 

ex(l), termcap(5) 

AUTHOR 

William Joy 

BUGS 

SUPPORT 

COMPONENT NAME: termcap 
APPROVAL AUTHORITY: Local 
STATUS: Provisional 
SUPPLIER: HOCC 

USER INTERFACE: Program Counseling Service 
SUPPORT LEVEL: Provisional 
COMMENTS: 


4th Berkeley Distribution 
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NAME 

tmpfile - create a temporary file 

SYNOPSIS 

#include <stdio h> 

FILE * tmpfile () 

DESCRIPTION 

Tmpfile creates a temporary file and returns a corresponding FILE pointer. The file will automatically be 
deleted when the process using it terminates. The file is opened for update. 

SEE ALSO 

creat(2), unlink(2), fopen(3S), mktemp(3C), tmpnam(3S). 
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NAME 

tmpnam, tempnam - create a name for a temporary file 

SYNOPSIS 

#include <stdio h> 

char * tmpnam (s) 
char *s; 

char *tempnam (dir, pfx) 
char *dir, *pfx; 

DESCRIPTION 

These functions generate file names that can safely be used for a temporary file. 

Tmpnam always generates a file name using the path-name defined as P tmpdir in the <stdio.h> header 
file. If s is NULL, tmpnam leaves its result in an internal static area and returns a pointer to that area. The 
next call to tmpnam will destroy the contents of the area. If s is not NULL, it is assumed to be the address 
of an array of at least L tmpnam bytes, where L tmpnam is a constant defined in <stdio.h>\ tmpnam 
places its result in that array and returns s. 

Tempnam allows the user to control the choice of a directory. The argument dir points to the path-name of 
the directory in which the file is to be created. If dir is NULL or points to a string which is not a path-name 
for an appropriate directory, the path-name defined as P tmpdir in the <stdio.h> header file is used. If that 
path-name is not accessible, /tmp will be used as a last resort. This entire sequence can be up-staged by 
providing an environment variable TMPDIR in the user’s environment, whose value is a path-name for the 
desired temporary-file directory. 

Many applications prefer their temporary files to have certain favorite initial letter sequences in their names. 
Use the pfx argument for this. This argument may be NULL or point to a string of up to five characters to 
be used as the first few characters of the temporary-file name. 

Tempnam uses malloc{ 3C) to get space for the constructed file name, and returns a pointer to this area. 
Thus, any pointer value returned from tempnam may serve as an argument to free (see malloc{ 3C)). If 
tempnam cannot return the expected result for any reason, i.e. malloc failed, or none of the above men¬ 
tioned attempts to find an appropriate directory was successful, a NULL pointer will be returned. 

NOTES 

These functions generate a different file name each time they are called. 

Files created using these functions and either fopen or creat are temporary only in the sense that they reside 
in a directory intended for temporary use, and their names are unique. It is the user’s responsibility to use 
unlink ( 2) to remove the file when its use is ended. 

SEE ALSO 

creat(2), unlink(2), fopen(3S), malloc(3C), mktemp(3C), tmpfile(3S). 

BUGS 

If called more than 17,576 times in a single process, these functions will start recycling previously used 
names. 

Between the time a file name is created and the file is opened, it is possible for some other process to create 
a file with the same name. This can never happen if that other process is using these functions or mktemp, 
and the file names are chosen so as to render duplication by other means unlikely. 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric functions 

SYNOPSIS 

#include <math.h> 

double sin (x) 
double x; 

double cos (x) 
double x; 

double tan (x) 
double x; 

double asin (x) 
double x; 

double acos (x) 
double x; 

double atan (x) 
double x; 

double atan2 (y, x) 
double x, y; 

DESCRIPTION 

Sin, cos and tan return respectively the sine, cosine and tangent of their argument, which is in radians. 

Asin returns the arcsine of x, in the range -n/2 to Till. 

Acos returns the arccosine of x, in the range 0 to Jt. 

Atan returns the arctangent of x, in the range -n/2 to n/2. 

Atan2 returns the arctangent ofy/x, in the range -7t to n, using the signs of both arguments to determine the 
quadrant of the return value. 

DIAGNOSTICS 

Sin, cos and tan lose accuracy when their argument is far from zero. For arguments sufficiently large, 
these functions return 0 when there would otherwise be a complete loss of significance. In this case a mes¬ 
sage indicating TLOSS error is printed on the standard error output. For less extreme arguments, a PLOSS 
error is generated but no message is printed. In both cases, errno is set to ERANGE. 

Tan returns HUGE for an argument which is near an odd multiple of n/2 when the correct value would 
overflow, and sets errno to ERANGE. 

Arguments of magnitude greater than 1.0 cause asin and acos to return 0 and to set errno to EDOM. In 
addition, a message indicating DOMAIN error is printed on the standard error output. 

These error-handling procedures may be changed with the function matherr( 3M). 

SEE ALSO 

matherr(3M). 


Page 1 



TSEARCH(3C) 


TSEARCH(3C) 


NAME 

tsearch, tdelete, twalk - manage binary search trees 

SYNOPSIS 

#include <search h> 

char tsearch ((char *) key, (char **) rootp, compar) 
int (*compar)(); 

char tdelete ((char *) key, (char **) rootp, compar) 
int (*compar)(); 

void twalk ((char *) root, action) 
void (*action)(); 

DESCRIPTION 

Tsearch is a binary tree search routine generalized from Knuth (6.2.2) Algorithm T. It returns a pointer 
into a tree indicating where a datum may be found. If the datum does not occur, it is added at an appropri¬ 
ate point in the tree. Key points to the datum to be sought in the tree. Rootp points to a variable that points 
to the root of the tree. A NULL pointer value for the variable denotes an empty tree; in this case, the vari¬ 
able will be set to point to the datum at the root of the new tree. Compar is the name of the comparison 
function. It is called with two arguments that point to the elements being compared. The function must 
return an integer less than, equal to, or greater than zero according as the first argument is to be considered 
less than, equal to, or greater than the second. 

Tdelete deletes a node from a binary search tree. It is generalized from Knuth (6.2.2) algorithm D. The 
arguments are the same as for tsearch. The variable pointed to by rootp will be changed if the deleted node 
was the root of the tree. Tdelete returns a pointer to the parent of the deleted node, or a NULL pointer if the 
node is not found. 

Twalk traverses a binary search tree. Root is the root of the tree to be traversed. (Any node in a tree may 
be used as the root for a walk below that node.) Action is the name of a routine to be invoked at each node. 
This routine is, in turn, called with three arguments. The first argument is the address of the node being vis¬ 
ited. The second argument is a value from an enumeration data type typedef enum / preorder, postorder, 
endorder, leaf j VISIT: (defined in the <search.h> header file), depending on whether this is the first, second 
or third time that the node has been visited (during a depth-first, left-to-right traversal of the tree), or 
whether the node is a leaf. The third argument is the level of the node in the tree, with the root being level 
zero. 

NOTES 

The pointers to the key and the root of the tree should be of type pointer-to-element, and cast to type 
pointer-to-character. 

The comparison function need not compare every byte, so arbitrary data may be contained in the elements 
in addition to the values being compared. 

Although declared as type pointer-to-character, the value returned should be cast into type pointer-to- 
element. 

Warning: the root argument to twalk is one level of indirection less than the rootp arguments to tsearch 
and tdelete. 

DIAGNOSTICS 

A NULL pointer is returned by tsearch if there is not enough space available to create a new node. 

A NULL pointer is returned by tsearch and tdelete if rootp is NULL on entry. 

SEE ALSO 

bsearch(3C), hsearch(3C), lsearch(3C). 

BUGS 

Awful things can happen if the calling function alters the pointer to the root. 


Page 1 



TT YNAME (3C) 


TTYNAME(3C) 


NAME 

ttyname, isatty - find name of a terminal 
SYNOPSIS 

char *ttyname (hides) 
int hides; 

int isatty (Hides) 
int Hides; 

DESCRIPTION 

Ttyname returns a pointer to a string containing the null-terminated path name of the terminal device asso¬ 
ciated with file descriptor 

Isatty returns 1 if fildes is associated with a terminal device, 0 otherwise. 

FILES 

/dev/* 

DIAGNOSTICS 

Ttyname returns a NULL pointer if fildes does not describe a terminal device in directory /dev. 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

ttyslot - find the slot in the utmp file of the current user 

SYNOPSIS 

int ttyslot () 

DESCRIPTION 

Ttyslot returns the index of the current user’s entry in the /etc/utmp file. This is accomplished by actually 
scanning the file /etc/inittab for the name of the terminal associated with the standard input, the standard 
output, or the error output (0, 1 or 2). 

FILES 

/etc/inittab 

/etc/utmp 

SEE ALSO 

getut(3C), ttyname(3C). 

DIAGNOSTICS 

A value of 0 is returned if an error was encountered while searching for the terminal name or if none of the 
above file descriptors is associated with a terminal device. 
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NAME 

ungetc - push character back into input stream 

SYNOPSIS 

#include <stdio h> 

int ungetc (c, stream) 
char c; 

FILE * stream; 

DESCRIPTION 

Ungetc inserts the character c into the buffer associated with an input stream. That character, c , will be 
returned by the next getc call on that stream. Ungetc returns c, and leaves the file stream unchanged. 

One character of pushback is guaranteed provided something has been read from the stream and the stream 
is actually buffered. 

If c equals EOF, ungetc does nothing to the buffer and returns EOF. 

Fseek( 3S) erases all memory of inserted characters. 

SEE ALSO 

fseek(3S), getc(3S), setbuf(3S). 

DIAGNOSTICS 

In order that ungetc perform correctly, a read statement must have been performed prior to the call of the 
ungetc function. Ungetc returns EOF if it can’t insert the character. In the case that stream is stdin , ungetc 
will allow exactly one character to be pushed back onto the buffer without a previous read statement. 


Page 1 



X25ALNK(3C) 


X25ALNK(3C) 


NAME 

x25alnk, x25ilnk - attach or install a BX.25 link 

SYNOPSIS 

#include <x251ib.h> 

int x25alnk (linkid, devname, lineno, modname, 

int linkid, lineno; 

char *devname, *modname; 

unsigned flags; 

int x25ilnk (linkid, pktsize, flags) 
int linkid, pktsize; 
unsigned flags; 

DESCRIPTION 

X25alnk is used to attach a BX.25 logical link specified by linkid to a level 2 device whose name is 
devname by making the necessary connections between data structures. 

Linkid is the identifier for the link data structure to be used in the operating system. This identifier can be 
thought of as the connector between x25ipvc calls and the x25alnk call for the physical link on which the 
channels are multiplexed. An example of a link identifier is 1. 

Devname is the name of the physical device running the interpreter and script for this link, e.g., /dev/kmcO. 

Lineno is the physical line number (range 0-7) for a logical link on a physical unit, e.g., 4. 

Modname is the name of the synchronous modem control device. If the LNKMOD flag is specified, the 
standard modem control functions performed for the line are to raise data terminal ready and request to 
send. An example of modname is /dev/kdm(). 

Flags specifies the options for the attach call, e.g., LNKBACK requests devname as a backup device. The 
permissible flags bit settings for attach are: 

LNKMOD modname specified. 

LNKBACK attach a backup rather a primary device. 

X25ilnk is used to initialize a link; more precisely, to start the level 2 protocol in the associated device and 
to start the level 3 protocol in the UNIX System driver for the link specified by linkid. 

Pktsize is the packet size to be used for level 3 data packets. Pktsize must be a number that is a power of 2 
between 16 and 1024 inclusive. The default packet size is 128. The LNKPKT flag must be raised to set a 
non-default size. 

Flags specifies the options for the initialization call, e.g., LNKISB requests the B address. The permissible 
flags bit settings for initialization are: 

LNKPKT packet size specified 

LNKISB tell interpreter line is an X.25 B address; default is A. 

LNKBACK initialize the backup device. 

LNKFAST the device speed is greater than 9.6 KB. 

SEE ALSO 

ioctl(2), open(2), stat(2), perror(3C), x25clnk(3C), x25hlnk(3C). 
x25pvc(lM), nc(7), vpm(7), x25(7) in the UNIX System Administrator’s Manual. 

Operations Systems Network Protocol Specification: BX.25 Issue 2. Bell Laboratories. 

DIAGNOSTICS 

ELNKPKT packet size specified is illegal. 

ELNKNCO network control device open failed; check errno. 

ELNKNCI network control device ioctl failed; check errno. 

ELNKDS stat of physical device failed; check errno. 
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ELNKDNC 

ELNKMCO 

ELNKMCI 

ELNKLNO 


file associated with device name not a character special device, 
modem control device open failed; check errno. 
modem control device ioctl failed; check errno. 
device line number illegal. 
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NAME 

x25clnk - change over a BX.25 link 

SYNOPSIS 

#include <x251ib.h> 

int x25clnk (Iinkid) 
int Iinkid; 

DESCRIPTION 

X25clnk is used to change over from the primary to the backup level 2 device associated with link Iinkid. 
Linkid is the identifier for the link data structure which is used in the operating system. This identifier was 
set up by the x25alnk subroutine call. 

SEE ALSO 

ioctl(2), open(2), stat(2), perror(3C), x25alnk(3C), x25hlnk(3C). 
x25pvc(lM), nc(7), vpm(7), x25(7) in the UNIX System Administrator’s Manual . 

Operations Systems Network Protocol Specification: BX.25 Issue 2. Bell Laboratories. 

DIAGNOSTICS 

ELNKNCO network control device open failed; check errno. 

ELNKNCI network control device ioctl failed; check errno. 

ELNKDS stat of physical device failed; check errno. 

ELNKDNC file associated with device name not a character special device. 
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NAME 

x25hlnk, x25dlnk - halt or detach a BX.25 link 

SYNOPSIS 

#include <x251ib.h> 


int x25hlnk (linkid, flags) 
int linkid; 
unsigned flags; 

int x25dlnk (linkid, flags) 
int linkid; 
unsigned flags; 

DESCRIPTION 

X25hlnk is used to halt a link; more precisely, to stop the level 2 protocol in the associated device and to 
stop the level 3 protocol in the UNIX System driver for the link specified by linkid. If a backup device has 
been attached and started, the level 2 protocol on the backup will also be stopped. 

X25dlnk is used to detach a BX.25 logical link specified by linkid. This removes the logical connections 
which were made by x25alnk. 

Linkid is the identifier for the link data structure which is used in the operating system. This identifier was 
set up by the x25alnk subroutine call. 

Flags specifies the options for the halt or detach call. 

The permissible flags bit settings for halt is: 

LNKBACK halt only the level 2 protocol on the backup device. The level 3 protocol must not be 
running on this backup device. 

The permissible flags bit settings for detach is; 

LNKBACK detach a backup rather than a primary device. 

SEE ALSO 

ioctl(2), open(2), stat(2), perror(3C), x25alnk(3C), x25clnk(3C). 
x25pvc(lM), nc(7), vpm(7), x25(7) in the UNIX System Administrator’s Manual. 

Operations Systems Network Protocol Specification: BX.25 Issue 2. Bell Laboratories. 


DIAGNOSTICS 

ELNKNCO 

ELNKNCI 

ELNKDS 

ELNKDNC 


network control device open failed; check errno. 

network control device ioctl failed; check errno. 

stat of physical device failed; check errno. 

file associated with device name not a character special device. 
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NAME 

x25ipvc, x25rpvc - install or remove a PVC on a link 

SYNOPSIS 

#include <x251ib.h> 

int x25ipvc (slotname, chno, linkid, flags) 
char slotname; 
int chno, linkid; 
unsigned flags; 

int x25rpvc (slotname) 
char slotname; 

DESCRIPTION 

X25ipvc may be used to install a BX.25 Permanent Virtual Circuit (PVC) on a specified BX.25 interface 
(link). If slotname is currently connected (but removable) this connection is removed and the new connec¬ 
tion is made to the logical channel chno on the link specified by linkid. 

Slotname is a path name that specifies a BX.25 minor device (slot), e.g., /dev/x25sl2. 

Chno is the BX.25 level 3 logical channel number associated with the PVC, e.g., 3. chno must be in the 
range 1 to 4095 and must not be currently in use for any other BX.25 minor device associated with that link. 

Linkid is the identifier for the link data structure to be used in the operating system. This identifier can be 
thought of as the connector between x25ipvc calls and the x25alnk call for the physical link on which the 
channels are multiplexed. An example of a link identifier is 1. 

Flags contains settings for specifying PVC install options; permissible PVC flags bit settings are; 

PVCSESS Session connect/disconnect packets used. 

PVCREST RESET in-order/out-of-order responded to. 

PVCNONE No establishment protocol used. 

X25rpvc is used to remove the association between BX.25 minor device slotname and the link and channel 
to which it is currently connected. The command will fail if the slot is open, if packets are waiting to be 
transmitted, or if there are unacknowledged packets outstanding. 

SEE ALSO 

ioctl(2), open(2), stat(2), perror(3C). 

nc(7), vpm(7), x25(7) in the UNIX System Admninistrator’s Manual. 

Operations Systems Network Protocol Specification: BX.25 Issue 2. Bell Laboratories. 

DIAGNOSTICS 

EPVCNP no (or multiple) setup protocol specified (one of PVCSESS, PVCREST, or PVCNONE must be in 
flags argument). 

EPVCNCO network control device open failed; check errno. 

EPVCNCI network control device ioctl failed; check errno. 

EPVCSS stat of slot (PVC) name failed; check errno. 

EPVCSNC file associated with slotname not a character special device. 
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NAME 

intro - introduction to file formats 

DESCRIPTION 

This section outlines the formats of various files. The C struct declarations for the file formats are given 
where applicable. Usually, these structures can be found in the directories /usr/include or 
/usr/include/sys. 

References of the type namei IM) refer to entries found in Section 1 of the UNIX System Administrator’s 
Manual. 
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NAME 

a.out - common assembler and link editor output 

DESCRIPTION 

The file name a.out is the output file from the assembler as ( I) and the link editor ld( 1). Both programs 
will make a.out executable if there were no errors in assembling or linking and no unresolved external ref¬ 
erences. 

A common object file consists of a file header, a UNIX System header, a table of section headers, relocation 
information, (optional) line numbers, and a symbol table. The order is given below. 

File header. 

UNIX System header. 

Section 1 header. 

Section n header. 

Section 1 data. 

Section n data. 

Section 1 relocation. 

Section n relocation. 

Section 1 line numbers. 

Section n line numbers. 

Symbol table. 

The last three sections (relocation, line numbers and symbol table) may be missing if the program was 
linked with the -s option of ld(l) or if the symbol table and relocation bits were removed by strip (1). Also 
note that if there were no unresolved external references after linking, the relocation information will be 
absent. 

The sizes of each segment (contained in the header, discussed below) are in bytes and are even. 

When an a.out file is loaded into memory for execution, three logical segments are set up: the text segment, 
the data segment (initialized data followed by uninitialized, the latter actually being initialized to all 0’s), 
and a stack. The text segment begins at location 0 in the core image; the header is not loaded. If the magic 
number (the first field in the UNIX System header) is 407 (octal), it indicates that the text segment is not to 
be write-protected or shared, so the data segment will be contiguous with the text segment. If the magic 
number is 410 (octal), the data segment begins at the next segment boundary following the text segment, 
and the text segment is not writable by the program; if other processes are executing the same a.out file, 
they will share a single text segment. 

On the 3B20S, the stack begins at the end of the text and data sections and grows towards higher addresses. 
On the VAX, the stack begins at the end of memory and grows towards lower addresses. The stack is auto¬ 
matically extended as required. The data segment is extended only as requested by the brk{2) system call. 

The value of a word in the text or data portions that is not a reference to an undefined external symbol is 
exactly the value that will appear in memory when the file is executed. If a word in the text involves a ref¬ 
erence to an undefined external symbol, the storage class of the symbol-table entry for that word will be 
marked as an “external symbol", and the section number will be set to 0. When the file is processed by the 
link editor and the external symbol becomes defined, the value of the symbol will be added to the word in 
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the file. 

File Header 

The format of the filehdr header is 

struct filehdr 

{ 

unsigned short 
unsigned short 
long 
long 
long 

unsigned short 
unsigned short 

}; 

UNIX Header 

The format of the UNIX System header is 

typedef struct aouthdr { 


short 

magic; 

/* 

short 

vstamp; 

/* 

long 

tsize; 

/* 

long 

dsize; 

/* 

long 

bsize; 

/* 

long 

entry; 

/* 

long 

text start; 

/* 

long 

data start; 

/* 


} AOUTHDR; 

Section Header 

The format of the section header is 
struct scnhdr 


f magic; 

/* 

f nscns; 

/* 

f timdat; 

/* 

f symptr; 

/* 

f nsyms; 

/* 

f opthdr; 

/* 

f flags; 

/* 


magic number */ 
number of sections */ 
time and date stamp */ 
file ptr to symtab */ 

# symtab entries */ 
sizeoffopt hdr) */ 
flags */ 


magic number */ 
version stamp */ 
text size in bytes, padded */ 
initialized data (.data) */ 
uninitialized data (.bss) */ 
entry point */ 

base of text used for this file */ 
base of data used for this file */ 


char 

s name[SYMNMLEN];/* section name */ 

long 

s_paddr; 

/* physical address */ 

long 

s vaddr; 

/*■ virtual address */ 

long 

s size; 

/* section size */ 

long 

s scnptr; 

/* file ptr to raw data */ 

long 

s relptr; 

/* file ptr to relocation */ 

long 

s lnnoptr; 

/* file ptr to line numbers */ 

unsigned short 

s nreloc; 

/* # reloc entries */ 

unsigned short 

s nlnno; 

/* # line number entries */ 

long 

s flags; 

/* flags */ 
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Relocation 

Object files have one relocation entry for each relocatable reference in the text or data. If relocation infor¬ 
mation is present, it will be in the following format: 

struct reloc 

{ 

long r vaddr; /* (virtual) address of reference */ 

long r_symndx; /* index into symbol table *■/ 

short r type; /* relocation type */ 

}; 

The start of the relocation information is relptr from the Section Header. If there is no relocation informa¬ 
tion, relptr is 0. 

Symbol Table 

The format of the symbol table header is 

#define SYMNMLEN 8 

#define FILNMLEN 14 

#define SYMESZ 18 /* the size of a SYMENT */ 


struct syment 


char 

unsigned long 
short 

unsigned short 

char 

char 


nvalue; 
n type; 


n_name[SYMNMLEN]; /* name of symbol */ 
/* value of symbol */ 
nscnum;/* section number */ 

/* type and derived type */ 
n_sclass;/* storage class */ 
nnumaux;/* number of aux entries */ 


Some symbols require more information than a single entry; they are followed by auxiliary entries that are 
the same size as a symbol entry. The format follows: 
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union auxent { 
struct { 

long xtagndx; 
union { 

struct { 

unsigned short x lnno; 
unsigned short x size; 

} xlnsz; 
long x (size; 

} x_misc; 
union { 

struct { 

long x lnnoptr; 
long x endndx; 

} x fcn; 
struct { 

unsigned short x dimen [DIMNUM]; 

} xary; 

} x fcnary; 

unsigned short x_tvndx; 

} x_sym; 

struct { 

char xfname [FILNMLEN]; 

} x file; 

struct { 

long xscnlen; 
unsigned short x nreloc; 
unsigned short x_nlinno; 

} x_scn; 

struct { 

long x tvfill; 

unsigned short x tvlen; 
unsigned short x tvran[2]; 

} x_tv; 

}; 

Indexes of symbol table entries begin at zero. The start of the symbol table is symptr (from the file header) 
bytes from the beginning of the file. If the symbol table is stripped, symptr is 0. 

SEE ALSO 

as(l), cc(l), ld(l), filehdr(4), ldfcn(4), linenum(4), reloc(4), scnhdr(4), syms(4). 
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NAME 

a.out - PDP-11 assembler and link editor output 

DESCRIPTION 

A.out is the output file of the assembler as( I) and the link editor UK 1). Both programs will make a.out 
executable if there were no errors in assembling or linking and no unresolved external references. 

This file has four sections: a header, the program text and data segments, relocation information, and a sym¬ 
bol table (in that order). The last two sections may be missing if the program was linked with the -s option 
of ld( 1) or if the symbol table and relocation bits were removed by slripi 1). Also note that if there were no 
unresolved external references after linking, the relocation information will be removed. 

The sizes of each segment (contained in the header, discussed below) are in bytes and are even. The size of 
the header is not included in any of the other sizes. 

When an a.out file is loaded into memory for execution, three logical segments are set up: the text segment, 
the data segment (initialized data followed by uninitialized, the latter actually being initialized to all 0’s), 
and a stack. The text segment begins at location 0 in the core image; the header is not loaded. If the magic 
number (the first field in the header) is 407 (octal), it indicates that the text segment is not to be write- 
protected or shared, so the data segment will be contiguous with the text segment. If the magic number is 
410 (octal), the data segment begins at the first 0 mod 8K byte boundary following the text segment, and 
the text segment is not writable by the program; if other processes are executing the same a.out file, they 
will share a single text segment. If the magic number is 411 (octal) the text segment is again pure (write- 
protected and shared) and, moreover, the instruction and data spaces are separated; the text and data seg¬ 
ment both begin at location 0. See the PDP-11/70 Processor Handbook for restrictions that apply to this 
situation. 

The stack will occupy the highest possible locations in the core image: from 177776 (octal) on the PDP-11 
and growing downwards. The stack is automatically extended as required. The data segment is only 
extended as requested by the brk( 2) system call. 

The start of the text segment in the a.out file is hsize ; the start of the data segment is hsize+ S ( (the size of 
the text), where hsize is 20 (octal) on the PDP-11. 

The value of a word in the text or data portions that is not a reference to an undefined external symbol is 
exactly the value that will appear in memory when the file is executed. If a word in the text or data portion 
involves a reference to an undefined external symbol, as indicated by the relocation information (discussed 
below) for that word, then the value of the word as stored in the file is an offset from the associated external 
symbol. When the file is processed by the link editor and the external symbol becomes defined, the value 
of the symbol will be added to the word in the file. 

Header-PDP-11 

The format of the a.out header for the PDP-11 is as follows: 


struct 


exec 

short 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

char 

char 

char 

char 


{ 

a_magic; 

a_text; 

a_data; 

a_bss; 

a_syms; 

a entry; 


/* magic number */ 

/* size of text segment */ 

/* size of data segment */ 

/* size of bss segment */ 

/* size of symbol table */ 

/* entry point of program */ 
a unused; 

a hitext; /* hi bits for large text spaces */ 

a flag; /* set if relocation info stripped */ 

a_stamp; /* version stamp */ 
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Relocation-PDP-11 

If relocation information is present, it amounts to two bytes per relocatable datum. There is no relocation 
information if the “suppress relocation” flag ( ajlag ) in the header is on. 

The format of the relocation data is: 

struct r info { 

int rsymbolnum: 11, 
r_segment:3, 
r_pcrel: 1; 

}; 

The r_pcrel field indicates, if on , that the reference is relative to the program counter (pc) register (e.g., clr 
x); if off, that the reference is to the actual symbol (e.g., clr *$x). 

The rjsegment field indicates the segment referred to by the text or data word associated with the relocation 
word: 

00 indicates the reference is absolute; 

02 indicates the reference is to the text segment; 

04 indicates the reference is to initialized data; 

06 indicates the reference is to bss (uninitialized data); 

10 indicates the reference is to an undefined external symbol. 

The field r symbolnum contains a symbol number in the case of external references, and is unused other¬ 
wise. The first symbol is numbered 0, the second 1, etc. 

The start of the relocation information on the PDP-11 is: 

hsize +affext +ci_data 

Symbol Table-PDP-11 

The symbol table on the PDP-11 consists of entries of the form: 

struct nlist { 

char njiame[8]; 

int n type; 

unsigned n value; 

}; 

The njiame field contains the ASCII name of the symbol, null-padded. The njtype field indicates the type 
of the symbol; the following values are possible: 

00 undefined symbol 

01 absolute symbol 

02 text segment symbol 

03 data segment symbol 

04 bss segment symbol 

37 file name symbol (produced by ld( \ )) 

40 undefined external symbol 

41 absolute external symbol 

42 text segment external symbol 

43 data segment external symbol 

44 bss segment external symbol 

The start of the symbol table on the PDP-11 is: 

hsize +2(a_text +a_data ) 

if relocation information is present, and 

hsize +ajext +a_data 
if it is not. 
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If a symbol’s type on the PDP-11 is undefined external and the value field is non-zero, the symbol is inter¬ 
preted by the link editor ld( 1) as the name of a common region whose size is indicated by the value of the 
symbol. 

SEE ALSO 

as(l), ld(l), nm(l), strip(l). 
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NAME 

acct - per-process accounting file format 
SYNOPSIS 

#include <sys/acct h> 

DESCRIPTION 

Files produced as a result of calling acct(2) have records in the form defined by <sys/acct h>, whose con¬ 
tents are: 

typedef ushort comp t; /* "floating point" */ 

/* 13-bit fraction, 3-bit exponent */ 


struct acct 

r 



1 

char 

ac flag; 

/* Accounting flag */ 

char 

ac stat; 

/* Exit status */ 

ushort 

ac uid; 


ushort 

ac gid; 


dev t 

ac tty; 


time t 

ac btime; 

/* Beginning time */ 

comp t 

ac utime; 

/* acctng user time in clock ticks */ 

comp t 

ac stime; 

/* acctng system time in clock ticks */ 

comp t 

ac etime; 

/* acctng elapsed time in clock ticks */ 

comp t 

ac mem; 

/* memory usage in clicks */ 

comp t 

ac io; 

/* chars trnsfrd by read/write */ 

comp t 

ac rw; 

/* number of block reads/writes */ 

char 

}; 

ac comm[8]; /* command name */ 

extern struct 

acct 

acctbuf; 

extern struct 

inode 

*acctp; /* inode of accounting file */ 

#define AFORK 

01 

/* has executed fork, but no exec *■/ 

#define ASU 

02 

/* used super-user privileges */ 

#define ACCTF 

0300 

/* record type: 00 = acct */ 


In acjiag, the AFORK flag is turned on by each fork(2) and turned off by an exec(2). The ac_comm field 
is inherited from the parent process and is reset by any exec. Each time the system charges the process with 
a clock tick, it also adds to acjnem the current process size, computed as follows: 

(data size) + ( text size) / (number of in-core processes using text) 

The value of acjnem/(acjstime + acjutime) can be viewed as an approximation to the mean process size, 
as modified by text-sharing. 
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The structure tacct h, which resides with the source files of the accounting commands, represents the total 
accounting format used by the various accounting commands: 

/* 

* total accounting (for acct period), also for day 

*/ 


struct 


tacct { 



uid t 

ta uid; 

/* 

char 

ta name [8]; 

/* 

float 

ta cpu[2]; 

/* 

float 

ta kcore[2]; 

/* 

float 

ta con[2]; 

/* 

float 

ta du; 

/* 

long 

ta_pc; 

/* 

unsigned short 

ta sc; 

/* 

unsigned short 

ta dc; 

/* 

unsigned short 

ta fee; 

/* 


userid */ 
login name */ 

cum. cpu time, p/np (mins) */ 
cum kcore-minutes, p/np */ 
cum. connect time, p/np, mins */ 
cum. disk usage */ 
count of processes */ 
count of login sessions */ 
count of disk samples */ 
fee for special services */ 


SEE ALSO 

acct(lM), acctcom(l), acct(2). 

BUGS 

The acjnem value for a short-lived command gives little information about the actual size of the com¬ 
mand, because acjnem may be incremented while a different command (e.g., the shell) is being executed 
by the process. 


Page 2 



AR(4) 


(not on PDP-11) 


AR(4) 


NAME 

ar - common archive file format 

DESCRIPTION 

The archive command ar is used to combine several files into one. Archives are used mainly as libraries to 
be searched by the link editor ld{ 1). 

Each archive begins with an archive file header which is made up of the following components: 


#define 

ARMAG 

"<ar>" 

#define 

SARMAG 

4 


struct ar hdr | 

/* archive header */ 

char 

ar magic[SARMAG]; 

/* magic number */ 

char 

ar name [16]; 

/* archive name */ 

char 

ar date [4]; 

/* date of last archive modification */ 

char 

ar syms[4]; 

/* number of ar sym entries */ 


}; 


Each archive which contains common object files (see a.out( 4)) includes an archive symbol table. This 
symbol table is used by the link editor ld{ 1) to determine which archive members must be loaded during the 
link edit process. The archive file header described above is followed by a number of symbol table entries. 
The number of symbol table entries is indicated in the arjsyms variable. Each symbol table entry has the 
following format: 

struct ar_sym { /* archive symbol table entry */ 

char sym_name[8]; /* symbol name, recognized by Id */ 

char sym_ptr[4]; /* archive position of symbol */ 

}; 


The archive symbol table is automatically created and/or updated by the ar( 1) command. 

Following the archive header and symbol table are the archive file members. Each file member is preceded 
by a file member header which is of the following format: 


struct aif hdr 

{ 

/* archive file member header */ 

char 

aif name [16]; 

/* file member name */ 

char 

aif date [4]; 

/*■ file member date */ 

char 

aif uid[4]; 

/* file member user identification */ 

char 

arf gid[4]; 

/* file member group identification */ 

char 

aif mode [4]; 

/* file member mode */ 

char 

arf size [4]; 

/*■ file member size */ 


}; 


All information in the archive header, symbol table and file member headers is stored in a machine indepen¬ 
dent fashion. All character data is automatically portable. The numeric information contained in the head¬ 
ers is also stored in a machine independent fashion. All numeric data is stored as four bytes and is accessed 
by the special archive I/O functions described in sputl{ 3X) functions of the libld.a library. Common format 
archives can be moved from system to system as long as the portable archive command ar( 1) is used. Con¬ 
version tools such as arcv( 1) and convert ( I) exist to aid in the transportation of non-common format 
archives to this format. 

Each archive file member begins on a word boundary; a null byte is inserted between files if necessary. 
Nevertheless the size given reflects the actual size of the file exclusive of padding. 
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Notice there is no provision for empty areas in an archive file. 

SEE ALSO 

ar(l), arcv(l), convert(l), ld( 1), sputl(3X). 

BUGS 

The common archive structure is not compatible between the PDP-11 and the IBM-370, due to the different 
file formats. See arcv( 1) and convert{ 1) to convert between machines. 

Strip (1) will remove all archive symbol entries from the header. The archive symbol entries must be 
restored via the s option of the ar{ 1) command before the archive can be used with the link editor ld{ 1). 
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NAME 

ar - archive file format 

DESCRIPTION 

The archive command ar is used to combine several files into one. Archives are used mainly as libraries to 
be searched by the link editor ld{ 1). 

A file produced by ar has a magic number at the start, followed by the constituent files, each preceded by a 
file header. The magic number is 0177545(octal) (it was chosen to be unlikely to occur anywhere else). 
The header of each file is 26 bytes long: 

#define ARMAG 0177545 
struct ar_ hdr { 

char ar_name[14]; 
long ar_ date; 
char ar_uid; 
char argid; 
int armode; 
long arsize; 

}; 

Each file begins on a word boundary; a null byte is inserted between files if necessary. Nevertheless the 
size given reflects the actual size of the file exclusive of padding. 

Notice there is no provision for empty areas in an archive file. 

SEE ALSO 

ar(l), ld(l). 
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NAME 

checklist - list of file systems processed by fsck 

DESCRIPTION 

Checklist resides in directory /etc and contains a list of at most 15 special file names. Each special file 
name is contained on a separate line and corresponds to a file system. Each file system will then be auto¬ 
matically processed by the fsck( IM) command. 

SEE ALSO 

fsck(lM). 


Page 1 



CORE(4) 


CORE(4) 


NAME 

core - format of core image file 

DESCRIPTION 

The UNIX System writes out a core image of a terminated process when any of various errors occur. See 
signal( 2) for the list of reasons; the most common are memory violations, illegal instructions, bus errors, 
and user-generated quit signals. The core image is called core and is written in the process’s working 
directory (provided it can be; normal access controls apply). A process with an effective user ID different 
from the real user ID will not produce a core image. 

The first section of the core image is a copy of the system’s per-user data for the process, including the reg¬ 
isters as they were at the time of the fault. The size of this section depends on the parameter usize , which is 
defined in /usr/include/sys/param h. The remainder represents the actual contents of the user’s core area 
when the core image was written. If the text segment is read-only and shared, or separated from data space, 
it is not dumped. 

The format of the information in the first section is described by the user structure of the system, defined in 
/usr/include/sys/user.h. The important stuff not detailed therein is the locations of the registers, which are 
outlined in /usr/include/sys/reg.h. 

SEE ALSO 

crash(lM), sdb(l), setuid(2), signal(2). 
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NAME 

cpio - format of cpio archive 

DESCRIPTION 

The header structure, when the -c option of cpioi I) is not used, is: 

struct { 

short hmagic, 

hdev; 

ushort h ino, 

hmode, 

huid, 

h_gid; 

short h nlink, 

h rdev, 
h_mtime[2], 
h namesize, 
h_hlesize[2]; 

char h_name[h_namesize rounded to word]; 

} Hdr; 

When the -c option is used, the header information is described by: 

sscanf(Chdr,"%6o%6o%6o%6o%6o%6o%6o%6o% 1 llo%6o% 1 llo%s", 

&Hdi'.li magic, &Hdr h dev, &Hdr h ino, &Hdr.h mode, 

&Hdr.h_uid, &Hdr h gid, &Hdr h nlink, &Hdr h rdev, 

&Longtime, &Hdr.h namesize,&Longfile,Hdr h name); 

Longtime and Longfde are equivalent to Hdr.hjntime and Hdr.hjilesize , respectively. The contents of 
each file are recorded in an element of the array of varying length structures, archive , together with other 
items describing the file. Every instance of h magic contains the constant 070707 (octal). The items 
h dev through h jntime have meanings explained in stat{ 2). The length of the null-terminated path name 
h name, including the null byte, is given by hjiamesize. 

The last record of the archive always contains the name TRAILER!!!. Special files, directories, and the 
trailer are recorded with hjilesize equal to zero. 

SEE ALSO 

cpio(l), find(l), stat(2). 
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NAME 

dir - format of directories 

SYNOPSIS 

#include <sys/dir h> 

DESCRIPTION 

A directory behaves exactly like an ordinary file, save that no user may write into a directory. The fact that 
a file is a directory is indicated by a bit in the flag word of its i-node entry (see fs(A)). The structure of a 
directory entry as given in the include file is: 


#ifndef 

DIRSIZ 

#define 

DIRSIZ14 

#endif 


struct 

direct 

f 

ino t d ino; 


char d namefDIRSIZ]; 


}; 

By convention, the first two entries in each directory are for . and ... The first is an entry for the directory 
itself. The second is for the parent directory. The meaning of .. is modified for the root directory of the 
master file system; there is no parent, so .. has the same meaning as .. 

SEE ALSO 

fs(4). 
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NAME 

enfile - error-log file format 

DESCRIPTION 

When hardware errors are detected by the system, an error record is generated and passed to the error¬ 
logging daemon for recording in the error log for later analysis. The default error log is /usr/adm/errfile. 

The format of an error record depends on the type of error that was encountered. Every record, however, 
has a header with the following format: 

struct errhdr { 


short 

e type; 

/* record type */ 

short 

e len; 

/* bytes in record (inc hdr) */ 

time t 

1: 

e time; 

/* time of day */ 

permissible record types are as follows: 

#define EGOTS 

010 

/* start for the UNIX System 3.0*/ 

#define EGORT 

Oil 

/* start for the UNIX/RT System*/ 

#define E STOP 

012 

/* stop */ 

#define E TCHG 

013 

/* time change */ 

#define E CCHG 

014 

/* configuration change */ 

#define E BLK 

020 

/* block device error */ 

#define E STRAY 

030 

/* stray interrupt */ 

#define E PRTY 

031 

/* memory parity */ 

#define E PIO 

041 

/* 3B-20 programmed I/O */ 

#define E IOP 

042 

/* 3B-20 I/O processor */ 


Some records in the error file are of an administrative nature. These include the startup record that is 
entered into the file when logging is activated, the stop record that is written if the daemon is terminated 
“gracefully”, and the time-change record that is used to account for changes in the system’s time-of-day. 
These records have the following formats: 

struct estart { 


short 

e cpu; 

/* CPU type */ 

struct utsname e name; 

/* system names */ 

#ifndef u3b 

short 

e mmr3; 

/* contents mem mgmt reg 3 */ 

long 

e syssize; 

/* 11/70 system memory size */ 

short 

e bconf; 

/* block dev configuration */ 

#endif 

#ifdef u3b 

int 

e mmcnt; 

/* kbytes per array */ 


#endif 


#define eend errhdr /* record header */ 
struct etimchg { 

time_t e ntime; /* new time *■/ 

}; 
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Stray interrupts cause a record with the following format to be logged: 

struct estray { 

#ifdef u3b 

uint e_saddr; /* stray loc or device addr */ 

#else 

physadr e_saddr; /* stray loc or device addr */ 

short e_sbacty; /* active block devices */ 

#endif 

}; 

Memory subsystem error on 3B-20 and 11/70 processors cause the following record to be generated: 

struct eparity { 

#ifdef u3b 

int e_parreg[3]; /* 3B memory registers */ 

#else 

short e_parreg[4]; /* memory subsys registers */ 

#endif 

}; 

Memory subsystem errors on VAX-11/780 processors cause the following record to be generated: 

struct ememory { 

int e_sbier; 

int e_memcad; 

}; 

Error records for block devices have the following format: 

struct eblock { 

#ifdef u3b 


ushort 

struct iostat { 

e num; 

/* device number */ 

long 

io ops; 

/* number read/writes */ 

long 

io mi sc; 

/* number "other" operations */ 

ushort 

io unlog; 

/* number unlogged errors */ 

} 

e stats; 


short 

e bflags; 

/* read/write, error, etc */ 

daddr t 

e bnum; 

/* logical block number */ 

uint 

union ptbl { 

e bytes; 

/* number bytes to transfer */ 

int page [64]; 

/* page table entries */ 

union ptbl *pnext; 


} 

e_ptbl; 


struct ptbl 

e_ptbl; 

/* page table for transfer */ 

uint 

e voff; 

/* offset into page table */ 

uint 

e statl; 

/* status word 1 */ 

uint 

e stat2; 

/* status word 2 */ 


#endif 
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#ifndef u3b 

dev t e dev; /* "true" major + minor dev no */ 

physadr e regloc; /* controller address */ 

short e_bacty; /* other block I/O activity */ 

struct iostat { 

long io ops; /* number read/writes */ 

long iomisc; /* number "other" operations */ 

ushort io unlog; /* number unlogged errors */ 

} e_stats; 

short e bflags; /* read/write, error, etc */ 

short ecyloff; /* logical dev start cyl */ 

daddr_t e_bnum; /* logical block number */ 

ushort e_bytes; /* number bytes to transfer */ 

paddr_t e_memadd; /* buffer memory address */ 

ushort e rtry; /*■ number retries */ 

short e nreg; /* number device registers */ 

#endif 
#ifdef vax 

struct mba_regs { 
long mba_csr; 
long mba_cr; 
long mba_sr; 
long mba_var; 
long mba_vcr; 

} e_mba; 

#endif 

}; 

The following values are used in the e bflags word: 

#define E WRITE 0 /* write operation */ 

#define E READ 1 /*■ read operation */ 

#define E NOIO 02 /* no I/O pending */ 

#define E PHYS 04 /* physical I/O */ 

#define E MAP 010 /* Unibus map in use */ 

#define E ERROR 020 /* I/O failed */ 

The following error records are for the 3B-20 only: 

struct epio { /* programmed I/O (pio) error */ 

char e chan; /* which channel */ 

char e dev; /* which dev on channel */ 

uint e chstat; /* channel status */ 

uint e_cmd; /* pio command */ 

} 

struct eiop { /* I/O processor (iop) error */ 

char e unit; /* unit number */ 

uint e woi'dO; /*■ iop report word */ 

uint e wordl; /* iop report word */ 

} 
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The “true” major device numbers that identify the failing device are as follows: 


Digital Equipment 

Western Electric 

#define RKO 

0 

#define DFCO 

0 

#define RPO 

1 

#define IOPO 

1 

#define RFO 

2 

#define MTO 

2 

#define TMO 

3 



#define TCO 

4 



#define HPO 

5 



#define HTO 

6 



#define HSO 

7 



#define RLO 

8 



#define HPl 

9 



#define HP2 

10 



#define HP3 

11 




SEE ALSO 

errdemon(lM). 
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NAME 

filehdr - file header for common object files 

SYNOPSIS 

#include <filehdr h> 

DESCRIPTION 

Every common object file begins with a 20-byte header. The following C struct declaration is used: 
struct filehdr 
{ 

unsigned short f_magic ; /* magic number */ 
unsigned short fnscns ; /* number of sections */ 

long f timdat; /* time & date stamp */ 

long f symptr ; /* file ptr to symtab */ 

long fnsyms ; /* # symtab entries */ 

unsigned short f opthdr ; /* sizeofiopt hdr) */ 
unsigned short fflags ; /* flags */ 

}; 

Fjsymptr is the byte offset into the file at which the symbol table can be found. Its value can be used as the 
offset in fseek{ 3S) to position an I/O stream to the symbol table. The UNIX System optional header is 
always 36 bytes. The valid magic numbers are given below: 

#define N3BMAGIC 0550 /* 3B20S */ 

#define NTVMAGIC 0551 /* 3B20S */ 

#define VAXWRMAGIC 0570 /* VAX writable text segments */ 

#define VAXROMAGIC 0575 /* VAX readonly sharablc text segments */ 

The value in fjimdat is obtained from the time(2) system call. Flag bits currently defined are: 

#define F RELFLG 00001 /* relocation entries stripped */ 

#define FEXEC 00002 /* file is executable */ 

#define F LNNO 00004 /* line numbers stripped */ 

#define F LSYMS 00010 /* local symbols stripped */ 

#define FJV1INMAL 00020 /* minimal object file */ 

#define F UPDATE 00040 /* update file, ogen produced */ 

#define F SWABD 00100 /* file is "pre-swabbed" */ 

#define F AR16WR 00200 /* 16 bit DEC host */ 

#define F AR32WR 00400 /* 32 bit DEC host */ 

#define F AR32W 01000 /* non-DEC host */ 

#define F PATCH 02000 /* "patch" list in opt hdr */ 

SEE ALSO 

time(2), fseek(3S), a.out(4). 
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NAME 

file system - format of system volume 

SYNOPSIS 

#include <sys/filsys h> 

#include <sys/types h> 

#include <sys/param.h> 

DESCRIPTION 

Every file system storage volume has a common format for certain vital information. Every such volume is 
divided into a certain number of 512 byte long sectors. Sector 0 is unused and is available to contain a 
bootstrap program or other information. 

Sector 1 is the super-block. The format of a super-block is: 

/* 

* Structure of the super-block 


*/ 




struct 

; 

filsys 



1 

ushort 

s isize; 

/* size in blocks of i-list */ 


daddr t 

s fsize; 

/* size in blocks of entire volume */ 


short 

s nfree; 

/* number of addresses in s free */ 


daddr t 

s free [NICFREE]; 

/* free block list */ 


short 

s ninode; 

/* number of i-nodes in s inode */ 


ino t 

s inode [NICINOD]; 

/* free i-node list */ 


char 

s flock; 

/* lock during free list manipulation */ 


char 

s dock; 

/* lock during i-list manipulation */ 


char 

s fmod; 

/* super block modified flag */ 


char 

s ronly; 

/*■ mounted read-only flag */ 


time t 

s time; 

/* last super block update */ 


short 

s dinfo[4]; 

/* device information */ 


daddr t 

s tfree; 

/* total free blocks*/ 


ino t 

s tinode; 

/* total free inodes */ 


char 

s fname[6]; 

/* file system name */ 


char 

s fpack[6]; 

/* file system pack name */ 


long 

s_fill[13]; 

/* ADJUST to make sizeof filsys be 512 */ 


long 

s magic; 

/* magic number to indicate new file system */ 

}; 

long 

s type; 

/* type of new file system */ 

#define 

FsMAGIC 

0xfdl87e20 

/* s magic number */ 

#define 

Fslb 

1 

/* 512 byte block */ 

#define 

Fs2b 

2 

/* 1024 byte block */ 


Sjype indicates the file system type. Currently, two types of file systems are supported: the original 512- 
byte oriented and the new improved 1024-byte oriented. Sjnagic is used to distinguish the original 512- 
byte oriented file systems from the newer file systems. If this field is not equal to the magic number, 
FsMAGIC, the type is assumed to be Fslb, otherwise the s lype field is used. In the following description, 
a block is then determined by the type. For the original 512-byte oriented file system, a block is 512 bytes. 
For the 1024-byte oriented file system, a block is 1024 bytes or two sectors. The operating system takes 
care of all conversions from logical block numbers to physical sector numbers. 

Sisize is the address of the first data block after the i-list; the i-list starts just after the super-block, namely 
in block 2; thus the i-list is sjsize-2 blocks long. S_fsize is the first block not potentially available for 
allocation to a file. These numbers are used by the system to check for bad block numbers; if an 
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“impossible” block number is allocated from the free list or is freed, a diagnostic is written on the on-line 
console. Moreover, the free array is cleared, so as to prevent further allocation from a presumably cor¬ 
rupted free list. 

The free list for each volume is maintained as follows. The sjree array contains, in sjree [ I ], ..., 
s Jree[sjifree- 1], up to 49 numbers of free blocks. Sjree [0] is the block number of the head of a chain of 
blocks constituting the free list. The first long in each free-chain block is the number (up to 50) of free- 
block numbers listed in the next 50 longs of this chain member. The first of these 50 blocks is the link to 
the next member of the chain. To allocate a block: decrement sjifree, and the new block is 
sjree [sjifree ]. If the new block number is 0, there are no blocks left, so give an error. If sjifree became 
0, read in the block named by the new block number, replace sjifree by its first word, and copy the block 
numbers in the next 50 longs into the sjree array. To free a block, check if sjifree is 50; if so, copy 
sjifree and the sjree array into it, write it out, and set sjifree to 0. In any event set sjree [sjifree ] to the 
freed block's number and increment s jifree. 

Sjfree is the total free blocks available in the file system. 

Sninode is the number of free i-numbers in the sjnode array. To allocate an i-node; if sjiinode is greater 
than 0, decrement it and return sjnode [sjiinode], If it was 0, read the i-list and place the numbers of all 
free inodes (up to 100) into the sjnode array, then try again. To free an i-node, provided s ninode is less 
than 100, place its number into sjnode[sjiinode] and increment sjiinode. If sjiinode is already 100, do 
not bother to enter the freed i-node into any table. This list of i-nodes is only to speed up the allocation pro¬ 
cess; the information as to whether the inode is really free or not is maintained in the inode itself. 

Sjinode is the total free inodes available in the file system. 

SJiock and s ilock are flags maintained in the core copy of the file system while it is mounted and their 
values on disk are immaterial. The value of sjniod on disk is likewise immaterial; it is used as a flag to 
indicate that the super-block has changed and should be copied to the disk during the next periodic update 
of file system information. 

S ronly is a read-only flag to indicate write-protection. 

Sjime is the last time the super-block of the file system was changed, and is the number of seconds that 
have elapsed since 00:00 Jan. 1, 1970 (GMT). During a reboot, the sjime of the super-block for the root 
file system is used to set the system’s idea of the time. 

SJname is the name of the file system and sjpack is the name of the pack. 

I-numbers begin at 1, and the storage for i-nodes begins in block 2. Also, i-nodes are 64 bytes long. I-node 
1 is reserved for future use. I-node 2 is reserved for the root directory of the file system, but no other i- 
number has a built-in meaning. Each i-node represents one file. For the format of an inode and its flags, 
see inode( 4). 

FILES 

/usr/include/sys/filsys h 
/usr/include/sys/stat.h 

SEE ALSO 

fsck(lM), fsdb(lM), mkfs(lM), inode(4). 
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NAME 

fspec - format specification in text files 

DESCRIPTION 

It is sometimes convenient to maintain text files on the UNIX System with non-standard tabs, (i.e., tabs 
which are not set at every eighth column). Such files must generally be converted to a standard format, fre¬ 
quently by replacing all tabs with the appropriate number of spaces, before they can be processed by UNIX 
System commands. A format specification occurring in the first line of a text file specifies how tabs are to 
be expanded in the remainder of the file. 

A format specification consists of a sequence of parameters separated by blanks and surrounded by the 
brackets <: and :>. Each parameter consists of a keyletter, possibly followed immediately by a value. The 
following parameters are recognized: 

ttcibs The t parameter specifies the tab settings for the file. The value of tabs must be one of the 
following: 

1. a list of column numbers separated by commas, indicating tabs set at the specified 
columns; 

2. a - followed immediately by an integer n , indicating tabs at intervals of n columns; 

3. a - followed by the name of a “canned” tab specification. 

Standard tabs are specified by t-8, or equivalently, tl,9,17,25,etc. The canned tabs which are 
recognized are defined by the tabs( 1) command. 

s size The s parameter specifies a maximum line size. The value of size must be an integer. Size 

checking is performed after tabs have been expanded, but before the margin is prepended. 

m margin The m parameter specifies a number of spaces to be prepended to each line. The value of 
margin must be an integer. 

d The d parameter takes no value. Its presence indicates that the line containing the format 

specification is to be deleted from the converted file. 

e The e parameter takes no value. Its presence indicates that the current format is to prevail 

only until another format specification is encountered in the file. 

Default values, which are assumed for parameters not supplied, are t-8 and mO. If the s parameter is not 
specified, no size checking is performed. If the first line of a file does not contain a format specification, the 
above defaults are assumed for the entire file. The following is an example of a line containing a format 
specification: 

* <:t5,10,15 s72:> * 

If a format specification can be disguised as a comment, it is not necessary to code the d parameter. 

Several UNIX System commands correctly interpret the format specification for a file. Among them is gath 
(see send (Id) which may be used to convert files to a standard format acceptable to other UNIX System 
commands. 

SEE ALSO 

ed(l), newform(l), send(lC), tabs(l). 
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NAME 

gettydefs - speed and terminal settings used by getty 

DESCRIPTION 

The /etc/gettydefs file contains information used by getty(l M) (see the UNIX System Administrator’s 
Manual ) to set up the speed and terminal settings for a line. It supplies information on what the login 
prompt should look like. It also supplies the speed to try next if the user indicates the current speed is not 
correct by typing a <break> character. 

Each entry in /etc/gettydefs has the following format: 

label# initial-flags # final-flags # login-prompt #next-label 

Each entry is followed by a blank line. Lines that begin with # are ignored and may be used to comment 
the file. The various fields can contain quoted characters of the form \b, \n, \c, etc., as well as \nnn, where 
nnn is the octal value of the desired character. The various fields are: 

label This is the string against which getty tries to match its second argument. It is often the 

speed, such as 1200, at which the terminal is supposed to run, but it needn't be (see below). 

initial-flags These flags are the initial ioctl( 2) settings to which the terminal is to be set if a terminal type 

is not specified to getty. Getty understands the symbolic names specified in 
/usr/include/sys/termio h (see termiod ) in the UNIX System Administrator’s Manual). 
Normally only the speed flag is required in the initial-flags. Getty automatically sets the ter¬ 
minal to raw input mode and takes care of most of the other flags. The initial-flag settings 
remain in effect until getty executes login (1). 

final-flags These flags take the same values as the initial-flags and are set just prior to getty executes 
login. The speed flag is again required. The composite flag SANE takes care of most of the 
other flags that need to be set so that the processor and terminal are communicating in a 
rational fashion. The other two commonly specified final-flags are TAB3, so that tabs are 
sent to the terminal as spaces, and HUPCL, so that the line is hung up on the final close. 

login-prompt This entire field is printed as the login-prompt. Unlike the above fields where white space is 
ignored (a space, tab or new-line), they are included in the login-prompt field. 

next-label This indicates the next label of the entry in the table that getty should use if the user types a 
<break> or the input cannot be read. Usually, a series of speeds are linked together in this 
fashion, into a closed set. For instance, 2400 linked to 1200, which in turn is linked to 300, 
which finally is linked to 2400. 

If getty is called without a second argument, then the first entry of /etc/gettydefs is used, thus making the 
first entry of /etc/gettydefs the default entry. It is also used if getty can’t find the specified label. If 
/etc/gettydefs itself is missing, there is one entry built into the command which will bring up a terminal at 
300 baud. 

It is strongly recommended that after making or modifying /etc/gettydefs, it be run through getty with the 
check option to be sure there are no errors. 

FILES 

/etc/gettydefs 

SEE ALSO 

getty(lM), termio(7) in the UNIX System Administrator’s Manual. 
login(l), ioctl(2). 


Page 1 



GPS(4) 


GPS(4) 


NAME 

gps - graphical primitive string, format of graphical files 

DESCRIPTION 

GPS is a format used to store graphical data. Several routines have been developed to edit and display GPS 

files on various devices. Also, higher level graphics programs such as plot (in stat{ 1G)) and vtoc (in 

toe (1G)) produce GPS format output files. 

A GPS is composed of five types of graphical data or primitives. 

GPS PRIMITIVES 

lines The lines primitive has a variable number of points from which zero or more connected line 

segments are produced. The first point given produces a move to that location. (A move is a 
relocation of the graphic cursor without drawing.) Successive points produce line segments 
from the previous point. Parameters are available to set color, weight, and style (see below). 

arc The arc primitive has a variable number of points to which a curve is fit. The first point pro¬ 

duces a move to that point. If only two points are included a line connecting the points will 
result, if three points a circular arc through the points is drawn, and if more than three, lines 
connect the points. (In the future, a spline will be fit to the points if they number greater than 
three.) Parameters are available to set color, weight, and style. 

text The text primitive draws characters. It requires a single point which locates the center of the 

first character to be drawn. Parameters are color, font, textsize, and textangle. 

hardware The hardware primitive draws hardware characters or gives control commands to a hardware 
device. A single point locates the beginning location of the hardware string. 

comment A comment is an integer string that is included in a GPS file but causes nothing to be displayed. 
All GPS files begin with a comment of zero length. 

GPS PARAMETERS 

color Color is an integer value set for arc, lines, and text primitives. 

weight Weight is an integer value set for arc and lines primitives to indicate line thickness. The value 
0 is narrow weight, 1 is bold, and 2 is medium weight. 

style Style is an integer value set for lines and arc primitives to give one of the five different line 

styles that can be drawn on Tektronix 4010 series storage tubes. They are: 

0 solid 

1 dotted 

2 dot dashed 

3 dashed 

4 long dashed 

font An integer value set for text primitives to designate the text font to be used in drawing a char¬ 

acter string. (Currently font is expressed as a four-bit weight value followed by a four-bit style 
value.) 

textsize Textsize is an integer value used in text primitives to express the size of the characters to be 
drawn. Textsize represents the height of characters in absolute universe-units and is stored at 
one-fifth this value in the size-orientation (so) word (see below). 

textangle Textangle is a signed integer value used in text primitives to express rotation of the character 
string around the beginning point. Textangle is expressed in degrees from the positive x-axis 
and can be a positive or negative value. It is stored in the size-orientation (so) word as a value 
256/360 of it’s absolute value. 

ORGANIZATION 

GPS primitives are organized internally as follows: 
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lines 

arc 

text 

hardware 

comment 


cw points sw 
cw points sw 
cw point sw so [string ] 
cw point [string ] 
cw [string ] 


cw Cw is the control word and begins all primitives. It consists of four bits that contain a 

primitive-type code and twelve bits that contain the word-count for that primitive. 

point(s) Point(s) is one or more pairs of integer coordinates. Text and hardware primitives only 
require a single point. Point(s) are values within a Cartesian plane or universe having 64K 
(-32K to +32K) points on each axis. 

sw .S'iv is the style-word and is used in lines, arc, and text primitives. The first eight bits contain 

color information. In arc and lines the last eight bits are divided as four bits weight and four 
bits style. In the text primitive the last eight bits of sw contain the font. 

so So is the size-orientation word used in text primitives. The first eight bits contain text size and 

the remaining eight bits contain text rotation. 

string String is a null-terminated character string. If the string does not end on a word boundary an 
additional null is added to the GPS file to insure word-boundary alignment. 

SEE ALSO 

graphics(lG). 
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NAME 

group - group file 

DESCRIPTION 

Group contains for each group the following information: 

group name 
encrypted password 
numerical group ID 

comma-separated list of all user allowed in the group 

This is an ASCII file. The fields are separated by colons; each group is separated from the next by a new- 
line. If the password field is null, no password is demanded. 

This file resides in directory /etc. Because of the encrypted passwords, it can and does have general read 
permission and can be used, for example, to map numerical group ID’s to names. 

FILES 

/etc/group 
SEE ALSO 

newgrp(l), passwd(l), crypt(3C), passwd(4). 
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NAME 

inittab - script for the init process 

DESCRIPTION 

The inittab file supplies the script to init’ s role as a general process dispatcher. The process that constitutes 
the majority of init’ s process dispatching activities is the line process /etc/getty that initiates individual ter¬ 
minal lines. Other processes typically dispatched by init are daemons and the shell. 

The inittab file is composed of entries that are position dependent and have the following format: 

id:rstate:action:process 

Each entry is delimited by a newline, however, a backslash (\) preceding a newline indicates a continuation 
of the entry. Up to 512 characters per entry are permitted. Comments may be inserted in the process field 
using the sh( 1) convention for comments. Comments for lines that spawn getty s are displayed by the 
who (1) command. It is expected that they will contain some information about the line such as the loca¬ 
tion. There are no limits (other than maximum entry size) imposed on the number of entries within the 
inittab file. The entry fields are: 

id This is one to four characters used to uniquely identify an entry. 

rstate This defines the run-level in which this entry is to be processed. Run-levels effectively correspond 
to a configuration of processes in the system. That is, each process spawned by init is assigned a 
run-level or run-levels in which it is allowed to exist. The run-levels are represented by a number 
ranging from 0 through 6. As an example, if the system is in run-level 1, only those entries having 
a 1 in the rstate field will be processed. When init is requested to change run-levels, all processes 
which do not have an entry in the rstate field for the target run-level will be sent the warning sig¬ 
nal (SIGTERM) and allowed a 20 second grace period before being forcibly terminated by a kill 
signal (SIGKILL). The rstate field can define multiple run-levels for a process by selecting more 
than one run-level in any combination from 0-6. If no run-level is specified, then action will be 
taken on this process for all run-levels 0-6. There are three other values, a, b and c, which can 
appear in the rstate field, even though they are not true run-levels. Entries which have these char¬ 
acters in the rstate field are processed only when the telinit (see init( 1M)) process requests them to 
be run (regardless of the current run-level of the system). They differ from run-levels in that the 
system is only in these states for as long as it takes to execute all the entries associated with the 
states. A process started by an a, b or c command is not killed when init changes levels. They are 
only killed if their line in /etc/inittab is marked off in the action field, their line is deleted entirely 
from /etc/inittab, or init goes into the SINGLE USER state. 

action Key words in this field tell init how to treat the process specified in the process field. The actions 
recognized by init are as follows: 

respawn If the process does not exist then start the process, do not wait for its termination 
(continue scanning the inittab file), and when it dies restart the process. If the pro¬ 
cess currently exists then do nothing and continue scanning the inittab file. 

Upon init’ s entering the run-level that matches the entry’s rstate, start the process 
and wait for its termination. All subsequent reads of the inittab file while init is in 
the same run-level will cause init to ignore this entry. 

Upon init’ s entering a run-level that matches the entry’s rstate, start the process, do 
not wait for its termination and when it dies, do not restart the process. If upon enter¬ 
ing a new run-level, where the process is still running from a previous run-level 
change, the program will not be restarted. 

The entry is to be processed only at init’ s boot-time read of the inittab file. Init is to 
start the process, not wait for its termination, and when it dies, not restart the process. 
In order for this instruction to be meaningful, the rstate should be the default or it 
must match init’ s run-level at boot time. This action is useful for an initialization 
function following a hardware reboot of the system. 


wait 


once 


boot 
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bootwait The entry is to be processed only at init’s boot-time read of the inittab file. Init is to 
start the process, wait for its termination and, when it dies, not restart the process. 

powerfail Execute the process associated with this entry only when init receives a power fail 
signal (SIGPWR see signal( 2)). 

powerwait Execute the process associated with this entry only when init receives a power fail 
signal (SIGPWR) and wait until it terminates before continuing any processing of 
inittab. 


off If the process associated with this entry is currently running, send the warning signal 

(SIGTERM) and wait 20 seconds before forcibly terminating the process via the kill 
signal (SIGKILL). If the process is nonexistent, ignore the entry. 

ondemand This instruction is really a synonym for the respawn action. It is functionally identi¬ 
cal to respawn but is given a different keyword in order to divorce its association 
with run-levels. This is used only with the a, b or c values described in the rstate 
field. 


initdefault An entry with this action is only scanned when init initially invoked. Init uses this 
entry, if it exists, to determine which run-level to enter initially. It does this by tak¬ 
ing the highest run-level specified in the rstate field and using that as its initial state. 
If the rstate field is empty, this is interpreted as 0123456 and so init will enter run- 
level 6. Also, the initdefault entry can use s to specify that init start in the SINGLE 
USER state. Additionally, if init doesn't find an initdefault entry in /etc/inittab, then 
it will request an initial run-level from the user at reboot time. 

sysinit Entries of this type are executed before init tries to access the console. It is expected 
that this entry will be only used to initialize devices on which init might try to ask the 
run-level question. These entries are executed and waited for before continuing. 

process This is a sh command to be executed. The entire process field is prefixed with exec and passed to 
a forked sh as sh -c 'exec command'. For this reason, any legal sh syntax can appear in the the 
process field. Comments can be inserted with the ; #comment syntax. 


FILES 

/etc/inittab 


SEE ALSO 

getty(lM), init(lM) in the UNIX System Administrator’s Manual. 
sh(l), who(l), exec(2), open(2), signal(2). 
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NAME 

inode - format of an inode 


SYNOPSIS 

#include <sys/types h> 

#include <sys/ino.h> 

DESCRIPTION 

An i-node for a plain file or directory in 

/* Inode structure as it appears 
struct dinode 


ushort 

di mode; 

/* 

short 

di nlink; 

/* 

ushort 

di uid; 

/* 

ushort 

di gid; 

/* 

off t 

di size; 

/* 

char 

di_addr[40]; 

/* 

time t 

di atime; 

/* 

time t 

di mtime; 

/* 

time t 

di ctime; 

/* 


a file system has the following structure defined by <sys/ino h>. 
on a disk block. */ 


mode and type of file */ 
number of links to file */ 
owner’s user id */ 
owner’s group id */ 
number of bytes in file */ 
disk block addresses */ 
time last accessed */ 
time last modified */ 
time created */ 


/* 

* the 40 address bytes: 

* 39 used; 13 addresses 

* of 3 bytes each. 

*/ 

For the meaning of the defined types offj and timejt see types(5). 

FILES 

/usr/include/sys/ino.h 

SEE ALSO 

stat(2), fs(4), types(5). 
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NAME 

issue - issue identification file 

DESCRIPTION 

The file /etc/issue contains the issue or project identification to be printed as a login prompt. This is an 
ASCII file which is read by program getty and then written to any terminal spawned or respawned from the 
lines file. 

FILES 

/etc/issue 

SEE ALSO 

login(l). 
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NAME 

ldfcn - common object file access routines 

SYNOPSIS 

#include <stdio h> 

#include <filehdr h> 

#include <ldfcn h> 


DESCRIPTION 

The common object file access routines are a collection of functions for reading an object file that is in VAX 
or 3B20S (common) object file form. Although the calling program must know the detailed structure of the 
parts of the object file that it processes, the routines effectively insulate the calling program from knowl¬ 
edge of the overall structure of the object file. 

The interface between the calling program and the object file access routines is based on the defined type 
LDFILE, defined as struct ldfile, declared in the header file ldfcn h. The primary purpose of this structure 
is to provide uniform access to both simple object files and to object files that are members of an archive 
file. 


The function Idopen (3X) allocates and initializes the LDFILE structure and returns a pointer to the structure 
to the calling program. The fields of the LDFILE structure may be accessed individually through macros 
defined in ldfcn h and contain the following information: 

LDFILE *ldptr; 

TYPE(ldptr) The file magic number, used to distinguish between archive members and simple object 
files. 

OPTR(ldptr) The file pointer returned by fopen and used by the standard input/output functions. 

OFFSET(ldptr) The file address of the beginning of the object file; the offset is non-zero if the object file 

is a member of an archive file. 


HEADER(ldptr) The file header structure of the object file. 

The object file access functions themselves may be divided into four categories: 

(1) functions that open or close an object file 


Idopen (3X) and Idaopen 

open a common object file 
ldclose( 3X) and Idaclose 

close a common object file 

(2) functions that read header or symbol table information 

ldahread{ 3X) 

read the archive header of a member of an archive file 
ldfhread{ 3X) 

read the file header of a common object file 
ldshread( 3X) and Idnshread 

read a section header of a common object file 
ldtbread( 3X) 

read a symbol table entry of a common object file 

(3) functions that position an object file at (seek to) the start of the section, relocation, or line 
number information for a particular section. 

ldohseek( 3X) 

seek to the optional file header of a common object file 
ldsseek{ 3X) and Idnsseek 

seek to a section of a common object file 
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ldrseek(3X. ) and Idnrseek 

seek to the relocation information for a section of a common object file 
ldlseek( 3X) and Idnlseek 

seek to the line number information for a section of a common object file 
ldtbseek( 3X) 

seek to the symbol table of a common object file 

(4) the function ldtbindex( 3X) which returns the index of a particular common object file symbol 
table entry 

These functions are described in detail in their respective manual pages. 

All the functions except Idopen , Idaopen and Idtbindex return either SUCCESS or FAILURE, both constants 
defined in ldfcn h. Ldopen and Idaopen both return pointers to a LDFILE structure. 

MACROS 

Additional access to an object file is provided through a set of macros defined in ldfcn.h. These macros 
parallel the standard input/output file reading and manipulating functions, translating a reference of the 
LDFILE structure into a reference to its file descriptor field. 

The following macros are provided: 

LDFILE *ldptr; 

GETC(ldptr) 

FGETC(ldptr) 

GETW(ldptr) 

UNGETC(c, ldptr) 

FGETS(s, n, ldptr) 

FREAD((char *) ptr, sizeof (*ptr), nitems, ldptr) 

FSEEK) ldptr, offset, ptrname) 

FTELL(ldptr) 

REWIND) ldptr) 

FEOF(ldptr) 

FERROR(ldptr) 

FILENO(ldptr) 

SETBUFQdptr, but) 

See the manual entries for the corresponding standard input/output library functions for details on the use of 
these macros. 

The program must be loaded with the object file access routine library libld.a. 

CAVEAT 

The macro FSEEK defined in the header file ldfcn.h translates into a call to the standard input/output func¬ 
tion fseek{ 3S). FSEEK should not be used to seek from the end of an archive file since the end of an 
archive file may not be the same as the end of one of its object file members! 

SEE ALSO 

fseek(3S), ldahread(3X), ldclose(3X), ldfhread(3X), ldlread(3X), ldlseek(3X), ldohseek(3X), ldopen(3X), 
ldrseek(3X), ldlseek(3X), ldshread(3X), ldtbindex(3X), ldtbread(3X), ldtbseek(3X). 

Common Object File Format, by I. S. Law. 
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NAME 

linenum - line number entries in a common object file 
SYNOPSIS 

#include <linenum h> 

DESCRIPTION 

Compilers based on pcc generate an entry in the object file for each C source line on which a breakpoint is 
possible (when invoked with the -g option; see cc(l)). Users can then reference line numbers when using 
the appropriate software test system (see sdb{ 1)). The structure of these line number entries appears below. 

struct lineno 


union 


long I symndx ; 
long l_paddr; 

} I addr ; 

unsigned short llnno ; 


Numbering starts with one for each function. The initial line number entry for a function has l_ln.no equal 
to zero, and the symbol table index of the function’s entry is in l_symndx. Otherwise, l_lnno is non-zero, 
and /jpaddr is the physical address of the code for the referenced line. Thus the overall structure is the fol¬ 
lowing: 


/ addr 

l Inno 

function symtab index 

0 

physical address 

line 

physical address 

line 


function symtab index 

0 

physical address 

line 

physical address 

line 


SEE ALSO 

cc(l), sdb(l), a.out(4). 
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NAME 

master - master device information table 

DESCRIPTION 

This file is used by the configi 1M) program to obtain device information that enables it to generate the 
configuration files. The file consists of 3 parts, each separated by a line with a dollar sign ($) in column 1. 
Part 1 contains device information; part 2 contains names of devices that have aliases; part 3 contains tun¬ 
able parameter information. Any line with an asterisk (*) in column 1 is treated as a comment. 

Part 1 contains lines consisting of at least 10 fields and at most 13 fields, with the fields delimited by tabs 
and/or blanks: 

Field 1; device name (8 chars, maximum). 

Field 2: interrupt vector size (decimal, in bytes). 

Field 3: device mask (octal)-each “on” bit indicates that the handler exists: 

000100 initialization handler 
000040 power-failure handler 
000020 open handler 
000010 close handler 
000004 read handler 
000002 write handler 
000001 ioctl handler. 

Field 4: device type indicator (octal): 

000400 VAX-11/780 massbus adapter 

000200 allow only one of these devices 

000100 suppress count field in the conf.c file 

000040 suppress interrupt vector 

000020 required device 

000010 block device 

000004 character device 

000002 floating vector 

000001 fixed vector. 

Field 5: handler prefix (4 chars, maximum). 

Field 6: device address size (decimal). 

Field 7: major device number for block-type device. 

Field 8: major device number for character-type device. 

Field 9: maximum number of devices per controller (decimal). 

Field 10: maximum bus request level (4 through 7). 

Fields 11-13: optional configuration table structure declarations (8 chars, maximum). 

Part 2 contains lines with 2 fields each: 

Field 1: alias name of device (8 chars, maximum). 

Field 2: reference name of device (8 chars, maximum; specified in part 1). 

Part 3 contains lines with 2 or 3 fields each: 

Field 1: parameter name (as it appears in description file; 20 chars, maximum) 

Field 2: parameter name (as it appears in the conf.c file; 20 chars, maximum) 

Field 3: default parameter value (20 chars, maximum; parameter specification is required if 

this field is omitted) 

Devices that are not interrupt-driven have an interrupt vector size of zero. The 040 bit in Field 4 causes 
configi 1M) to record the interrupt vector although the low.s (univec.c on the VAX-11/780) file will show 
no interrupt vector assignment at those locations (interrupts here will be treated as strays). 

SEE ALSO 

config(lM). 
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NAME 

master - master device information table 

DESCRIPTION 

This file is used by the config (1M) program to obtain device information that enables it to generate the 

configuration file. Master contains lines of various forms for controlling the configuration of hardware 

devices, software drivers, parameters and aliases. 

Hardware devices and software drivers are defined as follows: 

Field 1: device name (8 chars maximum). 

Field 2: element type (dev, mhd, pc or sw) 

Field 3: functions for this device: 
o open handler 

c close handler 

r read handler 

w write handler 

i ioctl handler 

d diagnostic handler 

s startup routine 

f fork 

e exec 

x exit 

Field 4: element characteristics: 

o specify only once 

s supress count field 

r required device 

b block device 

c character device 

Field 5: handler prefix 

Field 6: major device number if block-type device 
Field 7: major device number if character-type device 
Field 8: number of sub-devices per device 
Field 9: diagnostic port number if diagnosable device 
Field 10: configuration table structure 

Parameters are defined as follows: 

Field 1: parameter name 
Field 2: element type (param) 

Field 3: element characteristics, as defined above 
Field 4: parameter name to appear in conf.c file 

UNIX System devices and UNIX System devices with arguments are defined as follows: 

Field 1: device name 

Field 2: element type (udev or udeva) 

Field 3: element characteristics, as defined above 
Field 4: device name to appear in conf.c file 

Aliases for names are defined as follows: 

Field 1: alias name 
Field 2: element type (alias) 

Field 3: reference name of device 

Lines to be ignored by the config program, but are necessary to the diagnostic system, are defined as fol¬ 
lows: 
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Field 1: name to be ignored 
Field 2: element type (ignore) 

SEE ALSO 

config(lM) sysdef(lM). 
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NAME 

mnttab - mounted file system table 
SYNOPSIS 

#include <mnttab.h> 


DESCRIPTION 

Mnttab resides in directory /etc and contains a table of devices, mounted by the mount( 1M) command, in 
the following structure as defined by <mnttab.h>: 


struct 


}; 


mnttab { 


char 

mt dev[10]; 

char 

mt filsys[ 10]; 

short 

mt ro fig; 

time t 

mt time; 


Each entry is 26 bytes in length; the first 10 bytes are the null-padded name of the place where the special 
file is mounted; the next 10 bytes represent the null-padded root name of the mounted special file; the 
remaining 6 bytes contain the mounted special file's read/write permissions and the date on which it was 
mounted. 

The maximum number of entries in mnttab is based on the system parameter NMOUNT located in 
/usr/src/uts/cf/conf.c, which defines the number of allowable mounted special files. 

SEE ALSO 

mount(lM), setmnt(lM). 
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NAME 

passwd - password file 

DESCRIPTION 

Passwd contains for each user the following information: 

login name 
encrypted password 
numerical user ID 
numerical group ID 

GCOS job number, box number, optional GCOS user ID 
initial working directory 
program to use as Shell 

This is an ASCII file. Each field within each user’s entry is separated from the next by a colon. The GCOS 
field is used only when communicating with that system, and in other installations can contain any desired 
information. Each user is separated from the next by a new-line. If the password field is null, no password 
is demanded; if the Shell field is null, the Shell itself is used. 

This file resides in directory /etc. Because of the encrypted passwords, it can and does have general read 
permission and can be used, for example, to map numerical user ID’s to names. 

The encrypted password consists of 13 characters chosen from a 64 character alphabet (., /, 0-9, A-Z, a-z), 
except when the password is null in which case the encrypted password is also null. Password aging is 
effected for a particular user if his encrypted password in the password file is followed by a comma and a 
non-null string of characters from the above alphabet. (Such a string must be introduced in the first 
instance by the super-user.) 

The first character of the age, M say, denotes the maximum number of weeks for which a password is valid. 
A user who attempts to login after his password has expired will be forced to supply a new one. The next 
character, m say, denotes the minimum period in weeks which must expire before the password may be 
changed. The remaining characters define the week (counted from the beginning of 1970) when the pass¬ 
word was last changed. (A null string is equivalent to zero.) M and m have numerical values in the range 
0-63 that correspond to the 64 character alphabet shown above (i.e. / = 1 week; z = 63 weeks). If m = M = 
0 (derived from the string . or „) the user will be forced to change his password the next time he logs in 
(and the “age” will disappear from his entry in the password file). If m > M (signified, e.g., by the string 
./) only the super-user will be able to change the password. 

FILES 

/etc/passwd 

SEE ALSO 

login(l), passwd(l), a641(3C), crypt(3C), getpwent(3C), group(4). 


Page 1 



PLOT(4) 


PLOT (4) 


NAME 

plot - graphics interface 

DESCRIPTION 

Files of this format are produced by routines described in plot( 3X) and are interpreted for various devices 
by commands described in tplot( 1G). A graphics file is a stream of plotting instructions. Each instruction 
consists of an ASCII letter usually followed by bytes of binary information. The instructions are executed 
in order. A point is designated by four bytes representing the x and y values; each value is a signed integer. 
The last designated point in an 1, m, n, or p instruction becomes the “current point” for the next instruc¬ 
tion. 


Each of the following descriptions begins with the name of the corresponding routine in plot( 3X). 

m move: The next four bytes give a new current point. 

n cont: Draw a line from the current point to the point given by the next four bytes. See tploti I G). 

p point: Plot the point given by the next four bytes. 

1 line: Draw a line from the point given by the next four bytes to the point given by the following four 
bytes. 

t label: Place the following ASCII string so that its first character falls on the current point. The string is 
terminated by a new-line. 

e erase: Start another frame of output. 

f linemod: Take the following string, up to a new-line, as the style for drawing further lines. The styles 
are “dotted”, “solid”, “longdashed”, “shortdashed”, and “dotdashed”. Effective only for the 
-T4014 and -Tver options of tplot{ 1G) (Tektronix 4014 terminal and Versatec plotter). 

s space: The next four bytes give the lower left corner of the plotting area; the following four give the 
upper right corner. The plot will be magnified or reduced to fit the device as closely as possible. 

Space settings that exactly fill the plotting area with unity scaling appear below for devices supported by 

the filters of tplot{ 1G). The upper limit is just outside the plotting area. In every case the plotting area is 

taken to be square; points outside may be displayable on devices whose face is not square. 


DASI 300 
DASI 300s 
DASI 450 
Tektronix 4014 
Versatec plotter 


space(0, 0, 4096, 4096); 
space(0, 0, 4096, 4096); 
space(0, 0, 4096, 4096); 
space(0, 0,3120,3120); 
space(0, 0, 2048, 2048); 


SEE ALSO 

graph(lG), tplot(lG), plot(3X), gps(4), term(5). 
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NAME 

pnch - file format for card images 

DESCRIPTION 

The PNCH format is a convenient representation for files consisting of card images in an arbitrary code. 

A PNCH file is a simple concatenation of card records. A card record consists of a single control byte fol¬ 
lowed by a variable number of data bytes. The control byte specifies the number (which must lie in the 
range 0-80) of data bytes that follow. The data bytes are 8-bit codes that constitute the card image. If there 
are fewer than 80 data bytes, it is understood that the remainder of the card image consists of trailing 
blanks. 

SEE ALSO 

send(lC). 
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NAME 

profile - setting up an environment at login time 

DESCRIPTION 

If your login directory contains a file named .profile, that file will be executed (via the shell's exec .profile) 
before your session begins; .profiles are handy for setting exported environment variables and terminal 
modes. If the file /etc/profile exists, it will be executed for every user before the .profile. The following 
example is typical (except for the comments): 

# Make some environment variables global 
export MAIL PATH TERM 

# Set file creation mask 
umask 22 

# Tell me when new mail comes in 
MAIL=/usr/mail/myname 

# Add my /bin directory to the shell search sequence 
PATH=$PATH: SHOME/bin 

# Set terminal type 
echo "terminal; \c" 
read TERM 


case $TERM in 


300) 

stty cr2 nlO tabs; tabs;; 

300s) 

stty cr2 nlO tabs; tabs;; 

450) 

stty cr2 nlO tabs; tabs;; 

hp) 

stty crO nlO tabs; tabs;; 

745 1 735) 

stty crl nil -tabs; TERM=745;; 

43) 

stty crl nlO -tabs;; 

4014 I tek) 

stty crO nlO -tabs ffl; TERM=4014; echo "\33;";; 

*) 

echo "$TERM unknown";; 


esac 


FILES 

SHOME/.profile 

/etc/profile 

SEE ALSO 

env(l), login(l), mail(l), sh( 1), stty(l), su(l), environ(5), term(5). 
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NAME 

reloc - relocation information for a common object file 

SYNOPSIS 

#include <reloch> 

DESCRIPTION 

Object files have one relocation entry for each relocatable reference in the text or data. If relocation infor¬ 
mation is present, it will be in the following format. 


struct 

f 

reloc 



i 

long 

r vaddr; 

/* (virtual) address of reference / 


long 

r symndx ; 

/* index into symbol table / 

}; 

short 

r type ; 

/* relocation type / 

/* 




* All 

generics 




* reloc. already performed to symbol in the same section 

*/ 

#define R ABS 0 

/* 

* 3B generic 

* 24-bit direct reference 

* 24-bit "relative" reference 

* 16-bit optimized "indirect" TV reference 

* 24-bit "indirect" TV reference 

* 32-bit "indirect" TV reference 
*/ 

#define R DIR24 04 
#define R REL24 05 
#define R OPT 16 014 
#define R IND24 015 
#define R IND32 016 

/* 

* DEC Processors VAX 11/780 and VAX 11/750 


* 

*/ 

#define R RELBYTE 017 

#define R RELWORD 020 

#define R RELLONG 021 

#define R PCRBYTE 022 

#define R PCRWORD 023 

#define R PCRLONG 024 


As the link editor reads each input section and performs relocation, the relocation entries are read. They 
direct how references found within the input section are treated. 

R ABS The reference is absolute, and no relocation is necessary. The entry will be ignored. 
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R DIR24 
R REL24 


R OPT 16 


A direct, 24-bit reference to a symbol’s virtual address. 

A “PC-relative”, 24-bit reference to a symbol's virtual address. Relative references occur 
in instructions such as jumps and calls. The actual address used is obtained by adding a con¬ 
stant to the value of the program counter at the time the instruction is executed. 

An optimized, indirect, 16-bit reference through a transfer vector. The instruction contains 
the offset into the transfer vector table to the transfer vector where the actual address of the 
referenced word is stored. 


R IND24 An indirect, 24-bit reference through a transfer vector. The instruction contains the virtual 
address of the transfer vector, where the actual address of the referenced word is stored. 

R IND32 An indirect, 32-bit reference through a transfer vector. The instruction contains the virtual 
address of the transfer vector, where the actual address of the referenced word is stored. 


R RELBYTE A direct 8 bit reference to a symbol's virtual address. 

R RELWORD 

A direct 16 bit reference to a symbol’s virtual address. 

R RELLONG 

A direct 32 bit reference to a symbol’s virtual address. 

R PCRBYTE A “PC-relative”, 8 bit reference to a symbol’s virtual address. 

R PCRWORD 

A “PC-relative”, 16 bit reference to a symbol’s virtual address. 

R PCRLONG 

A “PC-relative”, 32 bit reference to a symbol’s virtual address. 

On the VAX processors relocation of a symbol index of -1 indicates that the relative difference between the 
current segment’s start address and the program’s load address is added to the relocatable address. 

Other relocation types will be defined as they are needed. 

Relocation entries are generated automatically by the assembler and automatically utilized by the link edi¬ 
tor. A link editor option exists for removing the relocation entries from an object file. 

SEE ALSO 

ld(l), strip(l), a.out(4), syms(4). 
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NAME 

sccsfile - format of SCCS file 

DESCRIPTION 

An SCCS file is an ASCII file. It consists of six logical parts: the checksum , the delta table (contains infor¬ 
mation about each delta), user names (contains login names and/or numerical group IDs of users who may 
add deltas), flags (contains definitions of internal keywords), comments (contains arbitrary descriptive 
information about the file), and the body (contains the actual text lines intermixed with control lines). 

Throughout an SCCS file there are lines which begin with the ASCII SOH (start of heading) character (octal 
001). This character is hereafter referred to as the control character and will be represented graphically as 
@. Any line described below which is not depicted as beginning with the control character is prevented 
from beginning with the control character. 

Entries of the form DDDDD represent a five digit string (a number between 00000 and 99999). 

Each logical part of an SCCS file is described in detail below. 

Checksum 

The checksum is the first line of an SCCS file. The form of the line is: 

@hDDDDD 

The value of the checksum is the sum of all characters, except those of the first line. The @h pro¬ 
vides a magic number of (octal) 064001. 

Delta table 

The delta table consists of a variable number of entries of the form: 

@S DDDDD/DDDDD/DDDDD 

@d <type> <SCCS ID> yr/mo/da hr:mi:se <pgmr> DDDDD DDDDD 
@i DDDDD ... 

@x DDDDD ... 

@g DDDDD ... 

@m <MR number> 


@c <comments>... 


@e 

The first line (@s) contains the number of lines inserted/deleted/unchanged respectively. The sec¬ 
ond line (@d) contains the type of the delta (currently, normal: D, and removed: R), the SCCS ID 
of the delta, the date and time of creation of the delta, the login name corresponding to the real 
user ID at the time the delta was created, and the serial numbers of the delta and its predecessor, 
respectively. 

The @i, @x, and @g lines contain the serial numbers of deltas included, excluded, and ignored, 
respectively. These lines are optional. 

The @m lines (optional) each contain one MR number associated with the delta; the @c lines con¬ 
tain comments associated with the delta. 

The @e line ends the delta table entry. 
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User names 

The list of login names and/or numerical group IDs of users who may add deltas to the file, sepa¬ 
rated by new-lines. The lines containing these login names and/or numerical group IDs are sur¬ 
rounded by the bracketing lines @u and @U. An empty list allows anyone to make a delta. 

Flags 

Keywords used internally (see admin { 1) for more information on their use). Each flag line takes 
the form: 


@f <flag> <optional text> 

The following flags are defined: 


@ft 

<type of program> 

@f V 

<program name> 

@fi 


@fb 


@f m 

<module name> 

@ff 

<floor> 

@f c 

<ceiling> 

@fd 

<default-sid> 

@f n 


@fj 


@fl 

<lock-releases> 

@f q 

<user defined> 

@f z 

<reserved for use in interfaces> 


The t flag defines the replacement for the %Y% identification keyword. The v flag controls 
prompting for MR numbers in addition to comments; if the optional text is present it defines an 
MR number validity checking program. The i flag controls the warning/error aspect of the “No id 
keywords” message. When the i flag is not present, this message is only a warning; when the i 
flag is present, this message will cause a ‘ ‘fatal’ ’ error (the file will not be gotten, or the delta will 
not be made). When the b flag is present the -b keyletter may be used on the get command to 
cause a branch in the delta tree. The m flag defines the first choice for the replacement text of the 
%M% identification keyword. The f flag defines the “floor” release; the release below which no 
deltas may be added. The c flag defines the “ceiling” release; the release above which no deltas 
may be added. The d flag defines the default SID to be used when none is specified on a get com¬ 
mand. The n flag causes delta to insert a “null” delta (a delta that applies no changes) in those 
releases that are skipped when a delta is made in a new release (e.g., when delta 5.1 is made after 
delta 2.7, releases 3 and 4 are skipped). The absence of the n flag causes skipped releases to be 
completely empty. The j flag causes get to allow concurrent edits of the same base SID. The 1 flag 
defines a list of releases that are locked against editing (get( 1) with the -e keyletter). The q flag 
defines the replacement for the %Q% identification keyword, z flag is used in certain specialized 
interface programs. 

Comments 

Arbitrary text surrounded by the bracketing lines @t and @T. The comments section typically 
will contain a description of the file’s purpose. 

Body 

The body consists of text lines and control lines. Text lines don't begin with the control character, 
control lines do. There are three kinds of control lines: insert, delete, and end, represented by: 

@1DDDDD 
@D DDDDD 
@E DDDDD 
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respectively. The digit string is the serial number corresponding to the delta for the control line. 

SEE ALSO 

admin(l), delta(l), get(l), prs(l). 

Source Code Control System User’s Guide in the UNIX System User’s Guide. 
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NAME 

scnhdr - section header for a common object file 
SYNOPSIS 

#include <scnhdr.h> 

DESCRIPTION 

Every common object file has a table of section headers to specify the layout of the data within the file. 
Each section within an object file has its own header. The C structure appears below. 

struct scnhdr 

{ 


char 

s name[SYMNMLEN]; /* section name */ 

long 

s_paddr; 

/* physical address */ 

long 

s vaddr; 

/* virtual address */ 

long 

s size; 

/* section size */ 

long 

s scnptr; 

/* file ptr to raw data */ 

long 

s relptr; 

/* file ptr to relocation */ 

long 

s lnnoptr; 

/* file ptr to line numbers */ 

unsigned short 

s nreloc; 

/* # reloc entries */ 

unsigned short 

s nlnno; 

/* # line number entries */ 

long 

s flags; 

/* flags */ 


}; 

File pointers are byte offsets into the file; they can be used as the offset in a call tofseek(3S). If a section is 
initialized, the file contains the actual bytes. An uninitialized section is somewhat different. It has a size, 
symbols defined in it, and symbols that refer to it. But it can have no relocation entries, line numbers, or 
data. Consequently, an uninitialized section has no raw data in the object file, and the values for sjscnptr, 
srelptr, s lnnoptr, s nreloc , and sjilnno are zero. 

SEE ALSO 

ld(l), fseek(3S), a.out(4). 
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NAME 

syms - common object file symbol table format 

SYNOPSIS 

#include <syms h> 

DESCRIPTION 

Common object files contain information to support symbolic software testing (see sdb( 1). Line number 
entries, linenum{ 4), and extensive symbolic information permit testing at the C source level. Every object 
file’s symbol table is organized as shown below. 

File name 1. 

Function 1. 

Local symbols for function 1. 

Function 2 

Local symbols for function 2. 

Static extents for file 1. 

File name 2. 

Function 1. 

Local symbols for function 1. 

Function 2. 

Local symbols for function 2. 

Static extents for file 2. 


Defined global symbols. 

Undefined global symbols. 

The entry for a symbol is a fixed-length structure. The members of the structure hold the name (null pad¬ 
ded), its value, and other information. The C structure is given below. 

#define SYMNMLEN 8 
#define FILNMLEN 14 

struct syment 

{ 

char n_name[SYMNMLENl ; 

long nvalue ;/* value of symbol */ 

short n_scnum ;/* section number */ 

unsigned short n type ; /* type and derived type */ 

char n_sclass ;/* storage class */ 

char n numaux ;/* number of aux entries */ 

}; 

Meaningful values and explanations for them are given in both syms.h and Common Object File Format. 
Anyone who needs to interpret the entries should seek more information in these sources. Some symbols 
require more information than a single entry; they are followed by auxiliary entries that are the same size as 
a symbol entry. The format follows. 
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union auxent 

{ 

struct 

{ 

long x_tagndx; 

union 

{ 

struct 

{ 

unsigned short x lnno; 
unsigned short x size; 

} x lnsz; 
long xfsize; 

} x_misc; 
union 
{ 

struct 

{ 

long xlnnoptr; 
long xendndx; 

} x_fcn; 

struct 

{ 

unsigned short x_dimen[DIMNUM]; 
} x_ary; 

} x fcnary; 

unsigned short x tvndx; 

} x_sym; 

struct 

{ 

char x_fname[FILNMLEN]; 

} x file; 

struct 

{ 

long xscnlen; 
unsigned short x nreloc; 
unsigned short x nlinno; 

} x_scn; 

struct 


unsigned short x tvlen; 
unsigned short x_tvran[2]; 
} x_tv; 

}; 

Indexes of symbol table entries begin at zero. 

SEE ALSO 

sdb(l), a.out(4), linenum(4). 

Common Object File Format by I. S. Law. 
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NAME 

system - format of 3B20S system description file 

DESCRIPTION 

This file contains information about the hardware configuration and system-dependent parameters for the 
user’s system. A more complete description of the system file is found in Setting up the UNIX System in 
the UNIX System Administrator’s Guide. This information is used by the config( 1M) program in 
configuring systems. The file is divided into two sections, separated by a line with a dollar sign ($) in col¬ 
umn 1. The first section describes the hardware configuration and the second contains system-dependent 
information. Any lines with a number sign (#) in column 1 are treated as comments and are ignored. Blank 
lines are also ignored. All fields may be separated by one or more space and tab characters. 

The following codes are used throughout the following description: 


Name 

Meaning 

chan 

channel 

count 

number of disk blocks in swap or dump area 

dev 

device on a channel 

devname 

name of device 

driver 

name of a software device driver 

equip 

equipage 

hv 

hardware version 

inter 

interrupt source bit 

low 

lowest disk block in swap or dump area 

minor 

minor device number 

mt 

maintenance type 

mv 

maintenance version 

num 

the number of instances of a software device driver 

parm 

name of a UNIX System parameter 

pc 

name of device driver for a PC 

pumpcode 

path name of pump code file 

slot 

slot number of a sub-device on its device 

unit 

logical unit number of a device 

value 

value of a UNIX System parameter 


Hardware Configuration 

This section describes the configuration of the Control Unit (CU) and its components, the Disk File Con¬ 
trollers (DFCs) and their Moving Head Disks (MHDs), and the Input Output Processors (IOPs) and their 
Peripheral Controllers (PCs). Any line that describes an IOP, DFC, MHD or PC may optionally have an 
exclamation point (!) preceding the first field. This indicates that a device should not automatically be 
brought into service by the system (see don( 1M)). Note that an exclamation point which precedes an IOP 
implies that neither the IOP nor its PCs will be brought into service. The same applies to a DFC and its 
MHDs. 

The CU and its components are specified as follows: 


unit 

chan 

dev 

mt 

mv 

hv 


cc 

unit 

mt 

mv 

hv 

equip 

0 

masc 

unit 

mt 

mv 

hv 

equip 

0 

sat 

unit 

mt 

mv 

hv 

equip 

0 

ch 

unit 

mt 

mv 

hv 

equip 

0 

ch 

unit 

mt 

mv 

hv 

equip 

0 

csu 

unit 

mt 

mv 

hv 

equip 

0 

dma 

unit 

mt 

mv 

hv 

equip 

0 
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ch unit 

mt 

mv 

hv 

equip inter 

Each DFC and its MHDs are specified 

as follows: 



dfc unit 

chan dev 

mt 

mv 

hv 

equip 

mhd 

unit slot 

mt 

mv 

hv 

equip 

Each IOP and its PCs 

are specified as follows: 




iop unit 

chan dev 

mt 

mv 

hv 

equip 

pc 

unit slot 

mt 

mv 

hv 

equip [pumpcode] 


System-Dependent Information 

This section specifies UNIX System devices, UNIX System parameters and software drivers. 

The root and pipe devices are specified by: 

root devname minor 
pipe devname minor 

The swap and dump devices are specified by: 

swap devname minor low count 
dump devname minor low count 

Tunable parameters are specified by: 

parm value 

Software drivers are specified in one of two forms: 

driver num 
driver 

SEE ALSO 

config(lM), don(lM), master(4). 

Setting up the UNIX System in the UNIX System Administrator’s Guide. 
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NAME 

utmp, wtmp - utmp and wtmp entry formats 
SYNOPSIS 

#include <sys/types h> 

#include <utmp h> 

DESCRIPTION 

These files, which hold user and accounting information for such commands as w/zo(l), write(1), and 
login (1), have the following structure as defined by <utmp.h>: 

#define UTMP FILE "/etc/utmp" 

#define WTMP FILE "/etc/wtmp" 

#define ut name ut user 

struct utmp { 
char 
char 
char 
short 
short 
struct 
short 
short 
} ut_exit; 

time_t 

}; 

/* Definitions for ut type */ 

#define EMPTY 0 

#define RUN LVL 1 

#define BOOT TIME 2 

#define OLD TIME 3 

#define NEW TIME 4 

#define INIT PROCESS 5 /* Process spawned by "init" */ 

#define LOGIN PROCESS 6 /* A "getty" process waiting for login */ 

#define USER PROCESS 7 /* A user process */ 

#define DEAD PROCESS 8 

#define ACCOUNTING 9 

#define UTMAXTYPE ACCOUNTING /* Largest legal value of ut type */ 

/* Special strings or formats used in the "ut line" field when */ 

/* accounting for something other than a process. */ 

/* No string for the ut line field can be more than 11 chars + */ 

/* a NULL in length. */ 

#define RUNLVL MSG "run-level %c" 

#define BOOT MSG "system boot" 

#define OTIME MSG "old time" 

#define NTIME MSG "new time" 

FILES 

/usr/include/utmp h 
/etc/utmp 
/etc/wtmp 


ut_user[8]; /* User login name */ 

ut_id[4]; /* /etc/inittab id (usually line #) */ 

ut line[12]; /* device name (console, lnxx) */ 

ut_pid; /* process id */ 

ut type; /* type of entry */ 

exit_status { 

e termination; /*■ Process termination status */ 
e exit; /* Process exit status */ 

/* The exit status of a process 
* marked as DEAD PROCESS. */ 
ut_time; /* time entry was made */ 
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SEE ALSO 

login(l), who(l), write(l), getut(3C). 
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NAME 

ascii - map of ASCII character set 

SYNOPSIS 

cat /usr/pub/ascii 

DESCRIPTION 

Ascii is a map of the ASCII character set, giving both octal and hexadecimal equivalents of each character, 
to be printed as needed. It contains: 


looo 

nu 1 

looi 

soh 

1 002 

s tx 

1 003 

e t x 

1 004 

eo t 

1 005 

enq 

1 006 

ack 

1 007 

be 1 | 

loio 

bs 

Ion 

ht 

1 012 

nl 

1 013 

vt 

1 014 

np 

1 015 

c r 

1 016 

so 

1 017 

s i 

1 020 

die 

1 021 

dc 1 

1 022 

dc2 

1 023 

dc3 

1 024 

dc4 

1 025 

nak 

1 026 

syn 

1 027 

etb | 

1 030 

can 

1 031 

em 

1 032 

sub 

1 033 

esc 

1 034 

f s 

1 035 

gs 

1 036 

r s 

1 037 

us 

1 040 

sp 

1 041 

| 

1 042 

" 

1 043 

# 

1 044 

$ 

1 045 

% 

1 046 

& 

1 047 


1 050 

( 

1 051 

) 

1 052 

* 

1 053 

+ 

1 054 

, 

1 055 

- 

1 056 

. 

1 057 

/ i 

1 060 

0 

1 061 

1 

1 062 

2 

1 063 

3 

1 064 

4 

1 065 

5 

1 066 

6 

1 067 

7 1 

1 070 

8 

1 071 

9 

1 072 


1 073 


1 074 

< 

1 075 

= 

1 076 

> 

1 077 

? 

1 100 

@ 

1 101 

A 

1 102 

B 

1 103 

c 

! 104 

D 

1 105 

E 

1 106 

F 

1 107 

G 1 

1 110 

H 

1 111 

I 

1 112 

J 

1 113 

K 

1 114 

L 

1 115 

M 

1 116 

N 

1 117 

O 1 

1 120 

P 

1 121 

Q 

1 122 

R 

1 123 

S 

1 124 

T 

1 125 

U 

1 126 

V 

1 127 

w 1 

1 130 

X 

1 131 

Y 

1 132 

Z 

1 133 

[ 

1 134 

\ 

1 135 

] 

1 136 


1 137 


1 140 

V 

1 141 

a 

1 142 

b 

1 143 

c 

1 144 

d 

1 145 

e 

1 146 

f 

1 147 

g ! 

1 150 

h 

1 151 

i 

1 152 

j 

1 153 

k 

1 154 

1 

1 155 

m 

1 156 

n 

1 157 

o 

1 160 

P 

1 161 

q 

1 162 

r 

1 163 

s 

1 164 

t 

1 165 

u 

1 166 

V 

1 167 

w 

1 170 

X 

1 171 

y 

1 172 

z 

1 173 

I 

1 174 

1 

1 175 

1 

1 176 


1 177 

de 1 I 

1 00 

nu 1 

1 01 

soh 

1 02 

s tx 

1 03 

e t x 

1 04 

eo t 

1 05 

enq 

1 06 

ack 

1 07 

be 1 I 

1 08 

bs 

1 09 

ht 

1 0a 

nl 

1 0b 

vt 

! 0c 

np 

1 Od 

c r 

1 Oe 

so 

1 Of 

s i 

! 10 

die 

1 11 

dc 1 

1 12 

dc2 

1 13 

dc3 

1 14 

dc4 

1 15 

nak 

1 16 

syn 

1 17 

etb I 

1 18 

can 

1 19 

em 

1 la 

sub 

1 lb 

esc 

1 lc 

f s 

1 Id 

gs 

1 le 

r s 

1 If 

us ! 

1 20 

sp 

1 21 

| 

1 22 

" 

1 23 

# 

1 24 

$ 

1 25 

% 

1 26 

& 

1 27 


I 28 

( 

1 29 

) 

1 2a 

* 

1 2b 

+ 

! 2c 

, 

1 2d 

- 

1 2e 

. 

1 2 f 

/ 1 

1 30 

0 

1 31 

1 

1 32 

2 

1 33 

3 

1 34 

4 

1 35 

5 

1 36 

6 

1 37 

7 1 

1 38 

8 

1 39 

9 

1 3a 


1 3b 

j 

1 3c 

< 

1 3d 

= 

1 3e 

> 

1 3 f 

? 

1 40 

@ 

1 41 

A 

1 42 

B 

1 43 

C 

1 44 

D 

1 45 

E 

1 46 

F 

1 47 

G 1 

1 48 

H 

1 49 

I 

1 4a 

J 

1 4b 

K 

1 4c 

L 

1 4d 

M 

1 4e 

N 

1 4f 

O 1 

1 50 

P 

1 51 

Q 

1 52 

R 

1 53 

S 

! 54 

T 

1 55 

U 

1 56 

V 

1 57 

w 1 

1 58 

X 

1 59 

Y 

1 5a 

Z 

1 5b 

[ 

1 5c 

\ 

1 5d 

] 

1 5e 


1 5 f 


1 60 

V 

1 61 

a 

1 62 

b 

1 63 

c 

1 64 

d 

1 65 

e 

1 66 

f 

1 67 

g 

1 68 

h 

1 69 

i 

1 6a 

j 

1 6b 

k 

1 6c 

1 

1 6d 

m 

1 6e 

n 

1 6f 

o 

1 70 

P 

1 71 

q 

1 72 

r 

1 73 

s 

1 74 

t 

1 75 

u 

1 76 

V 

1 77 

w 

1 78 

X 

1 79 

y 

1 7a 

z 

1 7b 

i 

1 7c 

1 

1 7d 

} 

1 7e 

~ 

1 7 f 

de 1 I 


FILES 

/usr/pub/ascii 
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NAME 

environ - user environment 

DESCRIPTION 

An array of strings called the “environment” is made available by exec{ 2) when a process begins. By con¬ 
vention, these strings have the form “name=value”. The following names are used by various commands: 

PATH The sequence of directory prefixes that sh( 1), time( 1), nice( 1), nohup{ 1), etc., apply in searching 
for a file known by an incomplete path name. The prefixes are separated by colons (:). Login(l) 
sets PATH=:/bin:/usr/bin. 

HOME Name of the user’s login directory, set by login( 1) from the password file passwd (4). 

TERM The kind of terminal for which output is to be prepared. This information is used by commands, 
such as mm{ 1) or tploti 1G), which may exploit special capabilities of that terminal. 

TZ Time zone information. The format is xxxnzzz where xxx is standard local time zone abbreviation, 
n is the difference in hours from GMT, and zzz is the abbreviation for the daylight-saving local 
time zone, if any; for example, EST5EDT. 

Further names may be placed in the environment by the export command and “name=value” arguments in 

sh{ 1), or by exec(2). It is unwise to conflict with certain shell variables that are frequently exported by 

.profile files: MAIL, PS1, PS2, IFS. 

SEE ALSO 

env(l), login(l), sh(l), exec(2), getenv(3C), profile(4), term(5). 
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NAME 

eqnchar - special character definitions for eqn and neqn 
SYNOPSIS 

eqn /usr/pub/eqnchar [ files ] I troff [ options ] 
neqn /usr/pub/eqnchar [ files ] I nroff [ options ] 

DESCRIPTION 

Eqnchar contains troff (1) and nroff character definitions for constructing characters that are not available 
on the Wang Laboratories, Inc. C/A/T phototypesetter. These definitions are primarily intended for use 
with eqn( 1) and neqn ; eqnchar contains definitions for the following characters: 


ciplus 

ciplus 

1 1 

II 

square 

square 

citimes 

citimes 

langle 

langle 

circle 

circle 

wig 

wig 

rangle 

rangle 

blot 

blot 

-wig 

-wig 

hbar 

hbar 

bullet 

bullet 

>wig 

> wig 

ppd 

ppd 

prop 

prop 

<wig 

< wig 

<-> 

«-> 

empty 

empty 

=wig 

= wig 

<=> 

<> 

member 

member 

star 

star 

1 < 

|< 

nomem 

nomem 

bigstar 

bigstar 

1 > 

|> 

cup 

cup 

•4»i 

II 

= dot 

ang 

ang 

cap 

cap 

orsign 

orsign 

rang 

rang 

incl 

incl 

andsign 

andsign 

3dot 

3 dot 

subset 

subset 

=del 

= del 

thf 

thf 

supset 

supset 

oppA 

oppA 

quarter 

quarter 

!subset 

! subset 

oppE 

oppE 

Squarter 

3 quarter 

Isupset 

! supset 

angstrom angstrom 

degree 

degree 

scrL 

scrL 

= =< 

= = < 

==> 

==> 




FILES 

/usr/pub/eqnchar 
SEE ALSO 

eqn(l), nroff(l), troff(l). 


Page 1 



FCNTL(5) 


FCNTL(5) 


NAME 

fcntl - file control options 

SYNOPSIS 

#include <fcntl h> 

DESCRIPTION 

The fcntl (2) function provides for control over open files. This include file describes requests and 
arguments to fcntl and open( 2). 

/* Flag values accessible to open(2) and fcntl(2) */ 

/* (The first three can only be set by open) */ 

#define O RDONLY 0 

#define O WRONLY 1 

#define O RDWR 2 

#define O NDELAY 04 /* Non-blocking I/O */ 

#define O APPEND 010 /* append (writes guaranteed at the end) */ 

/* Flag values accessible only to open(2) */ 

#define O CREAT 00400 /* open with file create (uses third open arg)*/ 

#define O TRUNC 01000 /* open with truncation */ 

#define O EXCL 02000 /* exclusive open */ 

/* fcntl(2) requests */ 

#define F DUPFD 0 /* Duplicate fildes */ 

#define F GETFD 1 /* Get fildes flags */ 

#define F_SETFD 2 /* Set fildes flags */ 

#define F GETFL 3 /* Get file flags */ 

#define F_SETFL 4 /* Set file flags */ 

SEE ALSO 

fcntl(2), open(2). 


Page 1 



GREEK(5) 


GREEK(5) 


NAME 

greek - graphics for the extended TTY-37 type-box 
SYNOPSIS 

cat /usr/pub/greek [ I greek -Tterminal ] 

DESCRIPTION 

Greek gives the mapping from ASCII to the “shift-out” graphics in effect between SO and SI on 
TELETYPE.nh 

Model 37 terminals equipped with a 128-character type-box. These are the default greek characters pro¬ 
duced by nroff. The filters of greek(l) attempt to print them on various other terminals. The file contains: 


alpha 

a 

A 

beta 

P 

B 

gamma 

Y 

\ 

GAMMA 

r 

G 

delta 

8 

D 

DELTA 

A 

W 

epsilon 

e 

S 

zeta 

c 

Q 

eta 

n 

N 

THETA 

0 

T 

theta 

0 

O 

lambda 


L 

LAMBDA 

A 

E 

mu 

B 

M 

nu 

V 

@ 

xi 

5 

X 

Pi 

71 

J 

PI 

n 

P 

rho 

P 

K 

sigma 

a 

Y 

SIGMA 

E 

R 

tau 

T 

I 

phi 

4> 

U 

PHI 

T> 

F 

psi 

¥ 

V 

PSI 

v 

H 

omega 

(0 

C 

OMEGA 

a 

z 

nabla 

V 

[ 

not 

—1 


partial 

d 

] 

integral 

I 






FILES 

/usr/pub/greek 
SEE ALSO 

300(1). 4014(1), 450(1), greek(l), hp(l), tc(l), nroff(l). 
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NAME 

intro - introduction to miscellany 

DESCRIPTION 

This section describes miscellaneous facilities such as macro packages, character set tables, etc. 
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NAME 

man - macros for formatting entries in this manual 

SYNOPSIS 

nroff -man files 


troff -man [ -rsl ] files 


DESCRIPTION 

These troff {\) macros are used to lay out the format of the entries of this manual. A skeleton entry may be 
found in the file /usr/man/u man/manO/skeleton. These macros are used by the man( 1) command. 

The default page size is 8.5"xll", with a 6.5"xl0" text area; the -rsl option reduces these dimensions to 
6"x9" and 4.75"x8.375", respectively; this option (which is not effective in nroff) also reduces the default 
type size from 10-point to 9-point, and the vertical line spacing from 12-point to 10-point. The -rV2 
option may be used to set certain parameters to values appropriate for certain Versatec printers; it sets the 
line length to 82 characters, the page length to 84 lines, and it inhibits underlining; this option should not be 
confused with the -Tvp option of the man{ 1) command, which is available at some UNIX System sites. 

Any text argument below may be one to six “words”. Double quotes ("") may be used to include blanks 
in a “word". If text is empty, the special treatment is applied to the next line that contains text to be 
printed. For example, .1 may be used to italicize a whole line, or ,SM followed by ,B to make small bold 
text. By default, hyphenation is turned off for nroff, but remains on for troff. 

Type font and size are reset to default values before each paragraph and after processing font- and size¬ 
setting macros, e.g., .1, ,RB, ,SM. Tab stops are neither used nor set by any macro except ,DT and ,TH. 

Default units for indents in are ens. When in is omitted, the previous indent is used. This remembered 
indent is set to its default value (7.2 ens in troff, 5 ens in nroff- this corresponds to 0.5" in the default page 
size) by ,TH, ,P, and ,RS, and restored by .RE. 


.TH t s c n 

•SH text 
.SS text 
,B text 
.1 text 
.SM text 
,RI a b 


.P 

.HP in 
.TP in 

.IP t in 

.RS in 

.RE k 

.PM m 

.DT 
.PD v 


Set the title and entry heading; t is the title, s is the section number, c is extra commentary, e.g., 
“local”, n is new manual name. Invokes .DT (see below). 

Place subhead text, e.g., SYNOPSIS, here. 

Place sub-subhead text, e.g.. Options, here. 

Make text bold. 

Make text italic. 

Make text 1 point smaller than default point size. 

Concatenate roman a with italic b, and alternate these two fonts for up to six arguments. Simi¬ 
lar macros alternate between any two of roman, italic, and bold: 

.IR .RB .BR .IB .BI 

Begin a paragraph with normal font, point size, and indent. .PP is a synonym for .P. 

Begin paragraph with hanging indent. 

Begin indented paragraph with hanging tag. The next line that contains text to be printed is 
taken as the tag. If the tag does not fit, it is printed on a separate line. 

Same as .TP in with tag f; often used to get an indented paragraph without a tag. 

Increase relative indent (initially zero). Indent all output an extra in units from the current left 
margin. 

Return to the kth relative indent level (initially, k= 1; k= 0 is equivalent to k= 1); if k is omitted, 
return to the most recent lower indent level. 

Produces proprietary markings; where m may be P for PRIVATE, N for NOTICE, BP for BELL 
LABORATORIES PROPRIETARY, or BR for BELL LABORATORIES RESTRICTED. 

Restore default tab settings (every 7.2 ens in troff, 5 ens in nroff). 

Set the interparagraph distance to v vertical spaces. If v is omitted, set the interparagraph dis¬ 
tance to the default value (0.4v in troff, lv in nroff). 


The following strings are defined: 
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\*R ® in troff , (Reg.) in nroff. 

\*S Change to default type size. 

\*(Tm Trademark indicator. 

The following number registers are given default values by .TH: 

IN Left margin indent relative to subheads (default is 7.2 ens in troff, 5 ens in nroff). 

LL Line length including IN. 

PD Current interparagraph distance. 

CAVEATS 

In addition to the macros, strings, and number registers mentioned above, there are defined a number of 
internal macros, strings, and number registers. Except for names predefined by troff and number registers 
d, m, and y, all such internal names are of the form XA , where X is one of ), ], and }, and A stands for any 
alphanumeric character. 

If a manual entry needs to be preprocessed by cw(l), eqn( 1) (or neqn), and/or tbl( 1), it must begin with a 
special line (described in man( 1)), causing the man command to invoke the appropriate preprocessor(s). 

The programs that prepare the Table of Contents and the Permuted Index for this Manual assume the NAME 
section of each entry consists of a single line of input that has the following format: 

name[, name, name ...] \- explanatory text 

The macro package increases the inter-word spaces (to eliminate ambiguity) in the SYNOPSIS section of 
each entry. 

The macro package itself uses only the roman font (so that one can replace, for example, the bold font by 
the constant-width font-see cw(l)). Of course, if the input text of an entry contains requests for other fonts 
(e.g., .1, .RB, \fl), the corresponding fonts must be mounted. 

FILES 

/usr/lib/tmac/tmac.an 
/usr/lib/macros/cmp. [nt]. [dt] .an 
/usr/lib/macros/ucmp.[nt].an 
/usr/man/[ua]_man/manO/skeleton 

SEE ALSO 

man(l), nroff(l), troff(l). 

BUGS 

If the argument to .TH contains any blanks and is not enclosed by double quotes (""), there will be bird- 
dropping-like things on the output. 
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NAME 

mm - the MM macro package for formatting documents 
SYNOPSIS 

mm [ options ] [ files ] 
nroff -mm [ options ] [ files ] 
nroff -cm [ options ] [ files ] 

mint [ options ] [ files ] 
troff -mm [ options ] [ files ] 
troff -cm [ options ] [ files ] 

DESCRIPTION 

This package provides a formatting capability for a very wide variety of documents. It is the standard pack¬ 
age used by the BTL typing pools and documentation centers. The manner in which a document is typed in 
and edited is essentially independent of whether the document is to be eventually formatted at a terminal or 
is to be phototypeset. See the references below for further details. 

The -mm option causes nroff and troff( 1) to use the non-compacted version of the macro package, while 
the -cm option results in the use of the compacted version, thus speeding up the process of loading the 
macro package. 

FILES 

/usr/lib/tmac/tmac m 
/usr/lib/macros/mm[nt] 

/usr/lib/macros/cmp.[nt].[dt] m 
/usr/lib/macros/ucmp.[nt] m 

SEE ALSO 

mm(l), mmt(l), nroff(l), trofffl). 

MM-Memorandum Macros by D. W. Smith and J. R. Mashey. 

Typing Documents with MM by D. W. Smith and E. M. Piskorik. 


pointer to the non-compacted version of the package 
non-compacted version of the package 
compacted version of the package 
initializers for the compacted version of the package 
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NAME 

mosd - the OSDD adapter macro package for formatting documents 
SYNOPSIS 

osdd [ options ] [ files ] 
mm -mosd [ options ] [ files ] 
nroff -mm -mosd [ options ] [ files ] 
nroff -cm -mosd [ options ] [ files ] 

nmit -mosd [ options ] [ files ] 
troff -mm -mosd [ options ] [ files ] 
troff -cm -mosd [ options ] [ files ] 

DESCRIPTION 

The OSDD adapter macro package is a tool used in conjunction with the MM macro package to prepare 
Operations Systems Deliverable Documentation. Many of the OSDD Standards are different than the 
default format provided by MM. The OSDD adapter package sets the appropriate MM options for automatic 
production of the OSDD Standards. The OSDD adapter package also generates the correct OSDD page head¬ 
ers and footers, heading styles. Table of Contents format, etc. 

OSDD document (input) files are prepared with the MM macros. Additional information which must be 
given at the beginning of the document file is specified by the following string definitions: 

.ds HI document-number 
.ds H2 section-number 
.ds H3 issue-number 
.ds H4 date 
.ds H5 rating 

The document-number should be of the standard 10 character format. The words “Section" and “Issue” 
should not be included in the string definitions; they will be supplied automatically when the document is 
printed. For example: 

.ds HI OPA-1P135-01 
.ds H2 4 
.ds H3 2 

automatically produces 
OPA-1P135-01 
Section 4 
Issue 2 

as the document page header. Quotation marks are not used in string definitions. 

If certain information is not to be included in a page header, then the string is defined as null; e.g., 

.ds H2 

means that there is no section-number. 

The OSDD Standards require that the Table of Contents be numbered beginning with Page 1 . By default, 
the first page of text will be numbered Page 2. If the Table of Contents has more than one page, for exam¬ 
ple n , then either -rP n+1 must be included as a command line option or nr P n must be included in the 
document file. For example, if the Table of Contents is four pages then use -rP5 on the command line or 
nr P 4 in the document file. 

The OSDD Standards require that certain information such as the document rating appear on the Document 
Index or on the Table of Contents page if there is no index. By default, it is assumed that an index has been 
prepared separately. If there is no index, the following must be included in the document file: 
nr Di 0 

This will ensure that the necessary information is included on the Table of Contents page. 
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The OSDD Standards require that all numbered figures be placed at the end of the document. The .Fg 
macro is used to produce full page figures. This macro produces a blank page with the appropriate header, 
footer, and figure caption. Insertion of the actual figure on the page is a manual operation. The macro 
usage is 

.Fg page-count "figure caption" 

where page-count is the number of pages required for a multi-page figure (default 1 page). 

Figure captions are produced by the .Fg macro using the .BS/.BE macros. Thus the .BS/.BE macros are also 
not available for users. The .Fg macro cannot be used within the document unless the final .Fg in a series 
of figures is followed by a .SK macro to force out the last figure page. 

The Table of Contents for OSDD documents (see Figure 4 in Section 4.1 of the OSDD Standards) is pro¬ 
duced with: 

.Tc 

System Type 
System Name 
Document Type 
.Td 

The .Tc/.Td macros are used instead of the .TC macro from MM. 

By default, the adapter package causes the NOTICE disclosure statement to be printed. The .PM macro 
may be used to suppress the NOTICE or to replace it with the PRIVATE disclosure statement as follows: 

.PM none printed 

.PM P PRIVATE printed 

. PM N NOTICE printed (default) 

The .P macro is used for paragraphs. The Np register is set automatically to indicate the paragraph number¬ 
ing style. It is very important that the .P macro be used correctly. All paragraphs (including those immedi¬ 
ately following a .H macro) must use a .P macro. Unless there is a .P macro, there will not be a number 
generated for the paragraph. Similarly, the .P macro should not be used for text which is not a paragraph. 
The .SP macro may be appropriate for these cases, e.g., for “paragraphs” within a list item. 

The page header format is produced automatically in accordance with the OSDD Standards. The OSDD 
Adapter macro package uses the .TP macro for this purpose. Therefore the .TP macro normally available in 
MM is not available for users. 

FILES 

/usr/lib/tmac/tmac.osd 
SEE ALSO 

mm(l), mmt(l), nroff(l), trofffl), mm(5). 

MM—Memorandum Macros by D. W. Smith and J. R. Mashey. 

Operations Systems Deliverable Documentation Standards , June 1980. 
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NAME 

mptx - the macro package for formatting a permuted index 
SYNOPSIS 

nroff -mptx [ options ] [ files ] 
troff -mptx [ options ] [ files ] 

DESCRIPTION 

This package provides a definition for the .xx macro used for formatting a permuted index as produced by 
ptx{ 1). This package does not provide any other formatting capabilities such as headers and footers. If 
these or other capabilities are required, the mptx macro package may be used in conjuction with the MM 
macro package. In this case, the -mptx option must be invoked after the -mm call. For example: 

nroff -cm -mptx file 
or 

mm -mptx file 

FILES 

/usr/lib/tmac/tmac.ptx pointer to the non-compacted version of the package 
/usr/lib/macros/ptx non-compacted version of the package 

SEE ALSO 

mm(l), nroffd), ptx(l), troffd), mm(5). 
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NAME 

mv - a troff macro package for typesetting view graphs and slides 
SYNOPSIS 

mvt [ -a ] [ options ] [ files ] 

troff [ -a ] [ -rXl ] -mv [ options ] [ files ] 

DESCRIPTION 

This package makes it easy to typeset view graphs and projection slides in a variety of sizes. A few macros 
(briefly described below) accomplish most of the formatting tasks needed in making transparencies. All of 
the facilities of troff{ 1), c\v( I), eqn( 1), and tbl( I) are available for more difficult tasks. 

The output can be previewed on most terminals, and, in particular, on the Tektronix 4014, as well as on the 
Versatec printer. For these two devices, specify the -rXl option (this option is automatically specified by 
the mvt command-q.v.-when that command is invoked with the -T4014 or -Tvp options). To preview 
output on other terminals, specify the -a option. 

The available macros are: 


.VS [»] [i] [d] 


.Vw 

[n] 

U1 

[d] 

.Vh 

[n] 

M 

[d] 

.VW 

[n] 

M 

[d] 

.VH 

[n] 

M 

[d] 

.Sw 

[n] 

M 

[d] 

.Sh 

[n] 

M 

[d] 

.SW 

[n] 

M 

[d] 

.SH 

[n] 

M 

[d] 

.A 

M 



.B 

[m 


1 


.C [m [s] ] 

.D [m [s] ] 

.T string 
.1 [in] [a [x] ] 


•S [pi Ul 


Foil-start macro; foil size is to be 7"x7"; n is the foil number, i is the foil identification, 
d is the date; the foil-start macro resets all parameters (indent, point size, etc.) to initial 
default values, except for the values of i and d arguments inherited from a previous 
foil-start macro; it also invokes the .A macro (see below). 

The naming convention for this and the following eight macros is that the first character 
of the name (V or S) distinguishes between view graphs and slides, respectively, while 
the second character indicates whether the foil is square (S), small wide (w), small high 
(h), big wide (W), or big high (H). Slides are “skinnier” than the corresponding view 
graphs: the ratio of the longer dimension to the shorter one is larger for slides than for 
view graphs. As a result, slide foils can be used for view graphs, but not vice versa; on 
the other hand, view graphs can accommodate a bit more text. 

Same as .VS, except that foil size is 7" wide x 5" high. 

Same as .VS, except that foil size is 5"x7". 

Same as .VS, except that foil size is 7"x5.4". 

Same as .VS, except that foil size is 7"x9". 

Same as .VS, except that foil size is 7"x5". 

Same as .VS, except that foil size is 5"x7". 

Same as .VS, except that foil size is 7"x5.4". 

Same as .VS, except that foil size is 7"x9". 

Place text that follows at the first indentation level (left margin); the presence of x sup¬ 
presses the / line spacing from the preceding text. 

Place text that follows at the second indentation level; text is preceded by a mark; m is 
the mark (default is a large bullet); s is the increment or decrement to the point size of 
the mark with respect to the prevailing point size (default is 0); if s is 100, it causes the 
point size of the mark to be the same as that of the default mark. 

Same as .B, but for the third indentation level; default mark is a dash. 

Same as .B, but for the fourth indentation level; default mark is a small bullet. 

String is printed as an over-size, centered title. 

Change the current text indent (does not affect titles); in is the indent (in inches unless 
dimensioned, default is 0); if in is signed, it is an increment or decrement; the presence 
of a invokes the .A macro (see below) and passes x (if any) to it. 

Set the point size and line length; p is the point size (default is “previous”); if p is 100, 
the point size reverts to the initial default for the current foil-start macro; if p is signed, 
it is an increment or decrement (default is 18 for .VS, .VH, and .SH, and 14 for the 
other foil-start macros); / is the line length (in inches unless dimensioned; default is 4.2" 
for .Vh, 3.8" for .Sh, 5" for .SH, and 6" for the other foil-start macros). 
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.DF n f [n /...] Define font positions; may not appear within a foil's input text (i.e., it may only appear 
after all the input text for a foil, but before the next foil-start macro); n is the position of 
font /; up to four ‘ ‘n /’ ’ pairs may be specified; the first font named becomes the 
prevailing font; the initial setting is (H is a synonym for G): 

.DF 1 H 2 I 3 B 4 S 

.DV [a] [ b ] [c] [d\ 

Alter the vertical spacing between indentation levels; a is the spacing for .A, b is for .B, 
c is for .C, and d is for .D; all non-null arguments must be dimensioned; null arguments 
leave the corresponding spacing unaffected; initial setting is: 

.DV ,5v .5v ,5v Ov 

.U strl [str2] Underline strl and concatenate str2 (if any) to it. 

The last four macros in the above list do not cause a break; the .1 macro causes a break only if it is invoked 
with more than one argument; all the other macros cause a break. 

The macro package also recognizes the following upper-case synonyms for the corresponding lower-case 
troff requests: 

.AD .BR .CE .FI .HY .NA .NF .NH .NX .SO .SP .TA .TI 
The Tm string produces the trademark symbol. 

The input tilde (~) character is translated into a blank on output. 

See the user’s manual cited below for further details. 

FILES 

/usr/lib/tmac/tmac.v 

/usr/lib/macros/vmca 

SEE ALSO 

cw(l), eqn(l), mmt(l), tbl(l), troff(l). 

A Macro Package for View Graphs and Slides by T. A. Dolotta and D. W. Smith. 

BUGS 

The .VW and .SW foils are meant to be 9" wide by 7" high, but because the typesetter paper is generally 
only 8" wide, they are printed 1" wide by 5.4" high and have to be enlarged by a factor of 9/7 before use as 
view graphs; this makes them less than totally useful. 
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NAME 

regexp - regular expression compile and match routines 
SYNOPSIS 

#define INIT <declarations> 

#define GETC() <getc code> 

#define PEEKC() <peekc code> 

#define UNGETC(c) <ungetc code> 

#deflne RETURN(pointer) <return code> 

#define ERROR!val) <error code> 

#include <regexp.h> 

char compilelinstring, expbuf, endbuf, eof) 
char instring, *expbuf, *endbuf; 

int step(string, expbuf) 
char string, expbuf; 

DESCRIPTION 

This page describes general purpose regular expression matching routines in the form of ed( 1), defined in 
/usr/include/regexp.h. Programs such as ed( 1), sed( 1), grep{ 1), bs( 1), expr( I), etc., which perform regu¬ 
lar expression matching use this source file. In this way, only this file need be changed to maintain regular 
expression compatibility. 

The interface to this file is unpleasantly complex. Programs that include this file must have the following 
five macros declared before the ‘ ‘#include <regexp h>' ’ statement. These macros are used by the compile 


routine. 


GETCQ 

Return the value of the next character in the regular expression pattern. Succes¬ 
sive calls to GETC() should return successive characters of the regular expression. 

PEEKC( ) 

Return the next character in the regular expression. Successive calls to PEEKC() 
should return the same character (which should also be the next character returned 
by GETCQ). 

UNGETC(c) 

Cause the argument c to be returned by the next call to GETCQ (and PEEKCQ). 
No more that one character of pushback is ever needed and this character is guar¬ 
anteed to be the last character read by GETC!). The value of the macro 
UNGETC(c) is always ignored. 

RETURN (pointer) 

This macro is used on normal exit of the compile routine. The value of the argu¬ 
ment pointer is a pointer to the character after the last character of the compiled 
regular expression. This is useful to programs which have memory allocation to 
manage. 

ERROR! val) 

This is the abnormal return from the compile routine. The argument val is an 
error number (see table below for meanings). This call should never return. 
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ERROR 

MEANING 

11 

Range endpoint too large. 

16 

Bad number. 

25 

‘ ‘\digit’ ’ out of range. 

36 

Illegal or missing delimiter. 

41 

No remembered search string. 

42 

\( \) imbalance. 

43 

Too many \(. 

44 

More than 2 numbers given in \{ \}. 

45 

} expected after Y 

46 

First number exceeds second in \{ \} 

49 

[ ] imbalance. 

50 

Regular expression overflow. 


The syntax of the compile routine is as follows: 
compile(instring, expbuf, endbuf, eof) 

The first parameter instring is never used explicitly by the compile routine but is useful for programs that 
pass down different pointers to input characters. It is sometimes used in the INIT declaration (see below). 
Programs which call functions to input characters or have characters in an external array can pass down a 
value of ((char *) 0) for this parameter. 

The next parameter expbuf is a character pointer. It points to the place where the compiled regular expres¬ 
sion will be placed. 

The parameter endbuf is one more than the highest address where the compiled regular expression may be 
placed. If the compiled expression cannot fit in ( endbuf—expbuf) bytes, a call to ERROR(50) is made. 

The parameter eof is the character which marks the end of the regular expression. For example, in ed( 1), 
this character is usually a /. 

Each program that includes this file must have a #define statement for INIT. This definition will be placed 
right after the declaration for the function compile and the opening curly brace ({). It is used for dependent 
declarations and initializations. Most often it is used to set a register variable to point the beginning of the 
regular expression so that this register variable can be used in the declarations for GETC(), PEEKCQ and 
UNGETCQ. Otherwise it can be used to declare external variables that might be used by GETC(), PEEKCQ 
and UNGETCQ. See the example below of the declarations taken from grep( 1). 

There are other functions in this file which perform actual regular expression matching, one of which is the 
function step. The call to step is as follows: 

step(string, expbuf) 

The first parameter to step is a pointer to a string of characters to be checked for a match. This string 
should be null terminated. 

The second parameter expbuf is the compiled regular expression which was obtained by a call of the func¬ 
tion compile. 

The function step returns one, if the given string matches the regular expression, and zero if the expressions 
do not match. If there is a match, two external character pointers are set as a side effect to the call to step. 
The variable set in step is loci. This is a pointer to the first character that matched the regular expression. 
The variable loc2, which is set by the function advance, points the character after the last character that 
matches the regular expression. Thus if the regular expression matches the entire line, loci will point to the 
first character of string and loc2 will point to the null at the end of string. 

Step uses the external variable circf which is set by compile if the regular expression begins with '. If this 
is set then step will only try to match the regular expression to the beginning of the string. If more than one 
regular expression is to be compiled before the first is executed the value of circf should be saved for each 
compiled expression and circf should be set to that saved value before each call to step. 
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The function advance is called from step with the same arguments as step. The purpose of step is to step 
through the string argument and call advance until advance returns a one indicating a match or until the 
end of string is reached. If one wants to constrain string to the beginning of the line in all cases, step need 
not be called, simply call advance. 

When advance encounters a * or \{ \} sequence in the regular expression it will advance its pointer to the 
string to be matched as far as possible and will recursively call itself trying to match the rest of the string to 
the rest of the regular expression. As long as there is no match, advance will back up along the string until 
it finds a match or reaches the point in the string that initially matched the * or \{ \}. It is sometimes desir¬ 
able to stop this backing up before the initial point in the string is reached. If the external character pointer 
Iocs is equal to the point in the string at sometime during the backing up process, advance will break out of 
the loop that backs up and will return zero. This is used be ed{\) and sed( 1) for substitutions done globally 
(not just the first occurrence, but the whole line) so, for example, expressions like s/y*//g do not loop for¬ 
ever. 


The routines ecmp and getrange are trivial and are called by the routines previously mentioned. 


EXAMPLES 

The following is an example of how the regular expression macros and calls look from grep( 1): 


#define INIT 
#define GETC() 
#define PEEKCQ 
#define UNGETC(c) 
#define RETURN(c) 
#define ERROR(c) 

#include <regexp h> 


register char *sp = instring; 
(*sp++) 

(*sp) 

(—sp) 
return; 
regerr() 


compile(*argv, expbuf, &expbuf[ESIZE], AO'); 


if(step(linebuf, expbuf)) 

succeedQ; 

FILES 

/usr/include/regexp. h 
SEE ALSO 

ed(l), grep(l), sed(l). 

BUGS 

The handling of circf is kludgy. 

The routine ecmp is equivalent to the Standard I/O routine strncmp and should be replaced by that routine. 
The actual code is probably easier to understand than this manual page. 
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NAME 

stat - data returned by stat system call 
SYNOPSIS 

#include <sys/types h> 

#include <sys/stat.h> 

DESCRIPTION 

The system calls stat and fstat return data whose structure is defined by this include file. The encoding of 
the field stjnode is defined in this file also. 

/* 

* Structure of the result of stat 

*/ 


struct 

{ 


stat 


dev t 

st dev; 

ino t 

st ino; 

ushort 

st mode; 

short 

st nlink; 

ushort 

st uid; 

ushort 

st gid; 

dev t 

st rdev; 

off t 

st size; 

time t 

st atime; 

time t 

st mtime; 

time t 

st ctime; 


#define S IFMT 0170000 /* type of file */ 
#define S IFDIR 0040000 /* directory */ 

#define S IFCHR 0020000 /* character special */ 
#define S IFBLK 0060000 /* block special */ 
#define SIFREG 0100000 /* regular */ 

#define S IFIFO 0010000 /* fifo */ 


#define S ISUID 04000 
#define S ISGID 02000 
#define S ISVTX 01000 
#define S IREAD 00400 
#define S IWRITE 00200 
#define S IEXEC 00100 

FILES 

/usr/include/sys/types h 
/usr/include/sys/stat.h 

SEE ALSO 

stat(2), types(5). 


/* set user id on execution */ 

/* set group id on execution */ 

/* save swapped text even after use */ 
/* read permission, owner */ 

/* write permission, owner */ 

/* execute/search permission, owner */ 
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NAME 

term - conventional names for terminals 

DESCRIPTION 

These names are used by certain commands (e.g., nroff, mm( 1), man( 1), tabs{ 1)) and are maintained as part 
of the shell environment (see sh(\),profile{A), and environ( 5)) in the variable $TERM: 

1520 Datamedia 1520 

1620 Diablo 1620 and others using the HyType II printer 

1620-12 same, in 12-pitch mode 

2621 Hewlett-Packard HP2621 series 

2631 Hewlett-Packard 2631 line printer 

2631-c Hewlett-Packard 2631 line printer - compressed mode 

2631-e Hewlett-Packard 2631 line printer - expanded mode 

2640 Hewlett-Packard HP2640 series 

2645 Hewlett-Packard HP264n series (other than the 2640 series) 

300 DASI/DTC/GSI 300 and others using the HyType I printer 

300-12 same, in 12-pitch mode 

300s DASI/DTC/GSI 300s 

382 DTC 382 

300s-12 same, in 12-pitch mode 

3045 Datamedia 3045 

33 TELETYPE nh 

Terminal Model 33 KSR 

37 TELETYPE Terminal Model 37 KSR 

40-2 TELETYPE Terminal Model 40/2 

40-4 TELETYPE Terminal Model 40/4 

4540 TELETYPE Terminal Model 4540 

3270 IBM Model 3270 

4000a Trendata 4000a 

4014 Tektronix 4014 

43 TELETYPE Model 43 KSR 

450 DASI 450 (same as Diablo 1620) 

450-12 same, in 12-pitch mode 
735 Texas Instruments TI735 and TI725 

745 Texas Instruments TI745 

dumb generic name for terminals that lack reverse 
line-feed and other special escape sequences 
sync generic name for synchronous TELETYPE 

4540-compatible terminals 
hp Hewlett-Packard (same as 2645) 

lp generic name for a line printer 

tnl200 General Electric TermiNet 1200 

tn300 General Electric TermiNet 300 

Up to 8 characters, chosen from [-a-z0-9], make up a basic terminal name. Terminal sub-models and 
operational modes are distinguished by suffixes beginning with a Names should generally be based on 
original vendors, rather than local distributors. A terminal acquired from one vendor should not have more 
than one distinct basic name. 

Commands whose behavior depends on the type of terminal should accept arguments of the form -T term 
where term is one of the names given above; if no such argument is present, such commands should obtain 
the terminal type from the environment variable $TERM, which, in turn, should contain term. 

SEE ALSO 

mm(l), nroffG), tplot(lG), sh(l), stty(l), tabs(l), profile(4), environ(5). 
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BUGS 

This is a small candle trying to illuminate a large, dark problem. Programs that ought to adhere to this 
nomenclature do so somewhat fitfully. 
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NAME 

termcap - terminal capability data base 

SYNOPSIS 

/etc/termcap 

DESCRIPTION 

Termcap is a data base describing terminals, used, e.g., by vi{ 1). Terminals are described in termcap by 
giving a set of capabilities which they have, and by describing how operations are performed. Padding 
requirements and initialization sequences are included in termcap. 

Entries in termcap consist of a number of separated fields. The first entry for each terminal gives the 
names which are known for the terminal, separated by ‘ I ’ characters. The first name is always 2 characters 
long and is used by older version 6 systems which store the terminal type in a 16 bit word in a systemwide 
data base. The second name given is the most common abbreviation for the terminal, and the last name 
given should be a long name fully identifying the terminal. The second name should contain no blanks; the 
last name may well contain blanks for readability. 

CAPABILITIES 

(P) indicates padding may be specified 

(P*) indicates that padding may be based on no. lines affected 


Name 

Type Pad? Description 

ae 

str 

(P) 

End alternate character set 

al 

str 

(P*) 

Add new blank line 

am 

bool 


Terminal has automatic margins 

as 

str 

(P) 

Start alternate character set 

be 

str 


Backspace if not "H 

bs 

bool 


Terminal can backspace with "H 

bt 

str 

(P) 

Back tab 

bw 

bool 


Backspace wraps from column 0 to last column 

CC 

str 


Command character in prototype if terminal settable 

cd 

str 

(P*) 

Clear to end of display 

ce 

str 

(P) 

Clear to end of line 

ch 

str 

(P) 

Like cm but horizontal motion only, line stays same 

cl 

str 

(P*) 

Clear screen 

cm 

str 

(P) 

Cursor motion 

CO 

num 


Number of columns in a line 

cr 

str 

(P*) 

Carriage return, (default ~M) 

cs 

str 

(P) 

Change scrolling region (vtlOO), like cm 

cv 

str 

(P) 

Like ch but vertical only. 

da 

bool 


Display may be retained above 

dB 

num 


Number of millisec of bs delay needed 

db 

bool 


Display may be retained below 

dC 

num 


Number of millisec of cr delay needed 

dc 

str 

(P*) 

Delete character 

dF 

num 


Number of millisec of ff delay needed 

dl 

str 

(P*) 

Delete line 

dm 

str 


Delete mode (enter) 

dN 

num 


Number of millisec of nl delay needed 

do 

str 


Down one line 

dT 

num 


Number of millisec of tab delay needed 

ed 

str 


End delete mode 

ei 

str 


End insert mode; give “:ei=:” if ic 

eo 

str 


Can erase overstrikes with a blank 

ff 

str 

(P*) 

Hardcopy terminal page eject (default ~L) 


Page 1 


4th Berkeley Distribution 



TERMCAP(5) (Provisional) 


he 

bool 


Hardcopy terminal 

hd 

str 


Half-line down (forward 1/2 linefeed) 

ho 

str 


Home cursor (if no cm) 

hu 

str 


Half-line up (reverse 1/2 linefeed) 

hz 

str 


Hazeltine; can’t print ~’s 

ic 

str 

(P) 

Insert character 

if 

str 


Name of file containing is 

im 

bool 


Insert mode (enter); give “:im=:” if ic 

in 

bool 


Insert mode distinguishes nulls on display 

ip 

str 

(P*) 

Insert pad after character inserted 

is 

str 


Terminal initialization string 

k0-k9 

str 


Sent by “other” function keys 0-9 

kb 

str 


Sent by backspace key 

kd 

str 


Sent by terminal down arrow key 

ke 

str 


Out of ‘ ‘keypad transmit’ ’ mode 

kh 

str 


Sent by home key 

kl 

str 


Sent by terminal left arrow key 

kn 

num 


Number of ‘ ‘other’ ’ keys 

ko 

str 


Termcap entries for other non-function keys 

kr 

str 


Sent by terminal right arrow key 

ks 

str 


Put terminal in “keypad transmit” mode 

ku 

str 


Sent by terminal up arrow key 

10-19 

str 


Labels on “other” function keys 

li 

num 


Number of lines on screen or page 

11 

str 


Last line, first column (if no cm) 

ma 

str 


Arrow key map, used by vi version 2 only 

mi 

bool 


Safe to move while in insert mode 

ml 

str 


Memory lock on above cursor. 

ms 

bool 


Safe to move while in standout and underline mode 

mu 

str 


Memory unlock (turn off memory lock). 

nc 

bool 


No correctly working carriage return (DM2500.H2000) 

nd 

str 


Non-destructive space (cursor right) 

nl 

str 

(P*) 

Newline character (default \n) 

ns 

bool 


Terminal is a CRT but doesn't scroll. 

os 

bool 


Terminal overstrikes 

pc 

str 


Pad character (rather than null) 

Pt 

bool 


Has hardware tabs (may need to be set with is) 

se 

str 


End stand out mode 

sf 

str 

(P) 

Scroll forwards 

sg 

num 


Number of blank chars left by so or se 

so 

str 


Begin stand out mode 

sr 

str 

(P) 

Scroll reverse (backwards) 

ta 

str 

(P) 

Tab (other than "I or with padding) 

tc 

str 


Entry of similar terminal - must be last 

te 

str 


String to end programs that use cm 

ti 

str 


String to begin programs that use cm 

uc 

str 


Underscore one char and move past it 

ue 

str 


End underscore mode 

ug 

num 


Number of blank chars left by us or ue 

ul 

bool 


Terminal underlines even though it doesn't overstrike 

up 

str 


Upline (cursor up) 

us 

str 


Start underscore mode 

vb 

str 


Visible bell (may not move cursor) 
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ve 

str 

vs 

str 

xb 

bool 

xn 

bool 

xr 

bool 

xs 

bool 

xt 

bool 


Sequence to end open/visual mode 
Sequence to start open/visual mode 
Beehive (fl=escape, f2=ctrl C) 

A newline is ignored after a wrap (Concept) 
Return acts like ce \r \n (Delta Data) 

Standout not erased by writing over it (HP 264?) 
Tabs are destructive, magic so char (Teleray 1061) 


A Sample Entry 


The following entry, which describes the Concept-100, is among the more complex entries in the termcap 
file as of this writing. (This particular concept entry is outdated, and is used as an example only.) 

cl I clOO I concept 100:is=\EU\Ef\E7VE5\E8\El\ENH\EKVE\200\Eo&\200:\ 

:al=3 *\E"R: am:bs:cd= 16*YE"C:ce= 16\E"S :cl=2*"L:cm=\Ea%+ %+ :co#80:\ 
:dc=16\E'A:dl=3*\E~B:ei=\E\200:eo:im=\E"P:in:ip=16*:li#24:mi:nd=\E=:\ 
:se=VEd\Ee:so=\ED\EE:ta=8\t:ul:up=\E;:vb=\Ek\EK:xn: 


Entries may continue onto multiple lines by giving a \ as the last character of a line, and that empty fields 
may be included for readability (here between the last field on a line and the first field on the next). Capa¬ 
bilities in termcap are of three types: Boolean capabilities which indicate that the terminal has some partic¬ 
ular feature, numeric capabilities giving the size of the terminal or the size of particular delays, and string 
capabilities, which give a sequence which can be used to perform particular terminal operations. 

Types of Capabilities 


All capabilities have two letter codes. For instance, the fact that the Concept has “automatic margins” (i.e. 
an automatic return and linefeed when the end of a line is reached) is indicated by the capability am. Hence 
the description of the Concept includes am. Numeric capabilities are followed by the character '#’ and then 
the value. Thus co which indicates the number of columns the terminal has gives the value ‘80’ for the 
Concept. 

Finally, string valued capabilities, such as ce (clear to end of line sequence) are given by the two character 
code, an ‘=’, and then a string ending at the next following A delay in milliseconds may appear after 
the ‘=’ in such a capability, and padding characters are supplied by the editor after the remainder of the 
string is sent to provide this delay. The delay can be either a integer, e.g. ‘20’, or an integer followed by an 
‘*\ i.e. ‘3*’. A indicates that the padding required is proportional to the number of lines affected by the 
operation, and the amount given is the per-affected-unit padding required. When a is specified, it is 
sometimes useful to give a delay of the form ‘3.5’ specify a delay per unit to tenths of milliseconds. 

A number of escape sequences are provided in the string valued capabilities for easy encoding of characters 
there. A \E maps to an ESCAPE character, ”x maps to a control-x for any appropriate x, and the sequences \n 
\r \t \b \f give a newline, return, tab, backspace and formfeed. Finally, characters may be given as three 
octal digits after a V and the characters ' and \ may be given as V and \\. If it is necessary to place a : in a 
capability it must be escaped in octal as \072. If it is necessary to place a null character in a string capabil¬ 
ity it must be encoded as \200. The routines which deal with termcap use C strings, and strip the high bits 
of the output very late so that a \200 comes out as a \000 would. 

Preparing Descriptions 

We now outline how to prepare descriptions of terminals. The most effective way to prepare a terminal 
description is by imitating the description of a similar terminal in termcap and to build up a description 
gradually, using partial descriptions with ex to check that they are correct. Be aware that a very unusual ter¬ 
minal may expose deficiencies in the ability of the termcap hie to describe it or bugs in ex. To easily test a 
new terminal description you can set the environment variable TERMCAP to a pathname of a hie contain¬ 
ing the description you are working on and the editor will look there rather than in /etc/termcap. TERM- 
CAP can also be set to the termcap entry itself to avoid reading the hie when starting up the editor. (This 
only works on version 7 systems.) 
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Basic capabilities 

The number of columns on each line for the terminal is given by the co numeric capability. If the terminal 
is a CRT, then the number of lines on the screen is given by the li capability. If the terminal wraps around to 
the beginning of the next line when it reaches the right margin, then it should have the am capability. If the 
terminal can clear its screen, then this is given by the cl string capability. If the terminal can backspace, 
then it should have the bs capability, unless a backspace is accomplished by a character other than "H (ugh) 
in which case you should give this character as the be string capability. If it overstrikes (rather than clear¬ 
ing a position when a character is struck over) then it should have the os capability. 

A very important point here is that the local cursor motions encoded in termcap are undefined at the left and 
top edges of a CRT terminal. The editor will never attempt to backspace around the left edge, nor will it 
attempt to go up locally off the top. The editor assumes that feeding off the bottom of the screen will cause 
the screen to scroll up, and the am capability tells whether the cursor sticks at the right edge of the screen. 
If the terminal has switch selectable automatic margins, the termcap file usually assumes that this is on, i.e. 
am. 

These capabilities suffice to describe hardcopy and “glass-tty” terminals. Thus the model 33 teletype is 
described as 

t3 I 33 I tty33:co#72:os 

while the Lear Siegler ADM-3 is described as 

cl I adm3131 lsi adm3:am:bs:cl=~Z:li#24:co#80 

Cursor addressing 

Cursor addressing in the terminal is described by a cm string capability, with printf( 3s) like escapes %x in 
it. These substitute to encodings of the current line or column position, while other characters are passed 
through unchanged. If the cm string is thought of as being a function, then its arguments are the line and 
then the column to which motion is desired, and the % encodings have the following meanings: 

%d as in printf, 0 origin 

%2 like %2d 

%3 like %3d 

%. like %c 

%+x adds x to value, then %. 

%>xy if value > x adds y, no output. 

%r reverses order of line and column, no output 
%i increments line/column (for 1 origin) 

%% gives a single % 

%n exclusive or row and column with 0140 (DM2500) 

%B BCD (16*(x/10)) + (x% 10), no output. 

%D Reverse coding (x-2*(x%16)), no output. (Delta Data). 

Consider the HP2645, which, to get to row 3 and column 12, needs to be sent \E&al2c03Y padded for 6 
milliseconds. Note that the order of the rows and columns is inverted here, and that the row and column are 
printed as two digits. Thus its cm capability is “cm=6\E&%r%2c%2Y”. The Microterm ACT-IV needs the 
current row and column sent preceded by a "T, with the row and column simply encoded in binary, 
“cm=~T%.%.”. Terminals which use “%.” need to be able to backspace the cursor (bs or be), and to 
move the cursor up one line on the screen (up introduced below). This is necessary because it is not always 
safe to transmit \t, \n ~I) and \r, as the system may change or discard them. 

A final example is the LSI ADM-3a, which uses row and column offset by a blank character, thus 
“cm=\E=%+ %+ 

Cursor motions 

If the terminal can move the cursor one position to the right, leaving the character at the current position 
unchanged, then this sequence should be given as nd (non-destructive space). If it can move the cursor up 
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a line on the screen in the same column, this should be given as up. If the terminal has no cursor address¬ 
ing capability, but can home the cursor (to very upper left corner of screen) then this can be given as ho; 
similarly a fast way of getting to the lower left hand corner can be given as 11 ; this may involve going up 
with up from the home position, but the editor will never do this itself (unless 11 does) because it makes no 
assumption about the effect of moving up from the home position. 

Area clears 

If the terminal can clear from the current position to the end of the line, leaving the cursor where it is, this 
should be given as ce. If the terminal can clear from the current position to the end of the display, then this 
should be given as cd. The editor only uses cd from the first column of a line. 

Insert/delete line 

If the terminal can open a new blank line before the line where the cursor is, this should be given as al; this 
is done only from the first position of a line. The cursor must then appear on the newly blank line. If the 
terminal can delete the line which the cursor is on, then this should be given as dl; this is done only from 
the first position on the line to be deleted. If the terminal can scroll the screen backwards, then this can be 
given as sb, but just al suffices. If the terminal can retain display memory above then the da capability 
should be given; if display memory can be retained below then db should be given. These let the editor 
understand that deleting a line on the screen may bring non-blank lines up from below or that scrolling back 
with sb may bring down non-blank lines. 

Insert/delete character 

There are two basic kinds of intelligent terminals with respect to insert/delete character which can be 
described using termcap. The most common insert/delete character operations affect only the characters on 
the current line and shift characters off the end of the line rigidly. Other terminals, such as the Concept 100 
and the Perkin Elmer Owl, make a distinction between typed and untyped blanks on the screen, shifting 
upon an insert or delete only to an untyped blank on the screen which is either eliminated, or expanded to 
two untyped blanks. You can find out which kind of terminal you have by clearing the screen and then typ¬ 
ing text separated by cursor motions. Type “abc def” using local cursor motions (not spaces) between 
the “abc” and the “def". Then position the cursor before the “abc” and put the terminal in insert mode. 
If typing characters causes the rest of the line to shift rigidly and characters to fall off the end, then your ter¬ 
minal does not distinguish between blanks and untyped positions. If the “abc” shifts over to the “def” 
which then move together around the end of the current line and onto the next as you insert, you have the 
second type of terminal, and should give the capability in, which stands for “insert null”. If your terminal 
does something different and unusual then you may have to modify the editor to get it to use the insert 
mode your terminal defines. We have seen no terminals which have an insert mode not not falling into one 
of these two classes. 

The editor can handle both terminals which have an insert mode, and terminals which send a simple 
sequence to open a blank position on the current line. Give as im the sequence to get into insert mode, or 
give it an empty value if your terminal uses a sequence to insert a blank position. Give as ei the sequence 
to leave insert mode (give this, with an empty value also if you gave im so). Now give as ic any sequence 
needed to be sent just before sending the character to be inserted. Most terminals with a true insert mode 
will not give ic, terminals which send a sequence to open a screen position should give it here. (Insert 
mode is preferable to the sequence to open a position on the screen if your terminal has both.) If post insert 
padding is needed, give this as a number of milliseconds in ip (a string option). Any other sequence which 
may need to be sent after an insert of a single character may also be given in ip. 

It is occasionally necessary to move around while in insert mode to delete characters on the same line (e.g. 
if there is a tab after the insertion position). If your terminal allows motion while in insert mode you can 
give the capability mi to speed up inserting in this case. Omitting mi will affect only speed. Some termi¬ 
nals (notably Datamedia’s) must not have mi because of the way their insert mode works. 

Finally, you can specify delete mode by giving dm and ed to enter and exit delete mode, and dc to delete a 
single character while in delete mode. 
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Highlighting, underlining, and visible bells 

If your terminal has sequences to enter and exit standout mode these can be given as so and se respectively. 
If there are several flavors of standout mode (such as inverse video, blinking, or underlining - half bright is 
not usually an acceptable “standout” mode unless the terminal is in inverse video mode constantly) the 
preferred mode is inverse video by itself. If the code to change into or out of standout mode leaves one or 
even two blank spaces on the screen, as the TVI 912 and Teleray 1061 do, then ug should be given to tell 
how many spaces are left. 

Codes to begin underlining and end underlining can be given as us and ue respectively. If the terminal has 
a code to underline the current character and move the cursor one space to the right, such as the Microterm 
Mime, this can be given as uc. (If the underline code does not move the cursor to the right, give the code 
followed by a nondestructive space.) 

Many terminals, such as the HP 2621, automatically leave standout mode when they move to a new line or 
the cursor is addressed. Programs using standout mode should exit standout mode before moving the cur¬ 
sor or sending a newline. 

If the terminal has a way of flashing the screen to indicate an error quietly (a bell replacement) then this can 
be given as vb; it must not move the cursor. If the terminal should be placed in a different mode during 
open and visual modes of ex, this can be given as vs and ve, sent at the start and end of these modes respec¬ 
tively. These can be used to change, e.g., from a underline to a block cursor and back. 

If the terminal needs to be in a special mode when running a program that addresses the cursor, the codes to 
enter and exit this mode can be given as ti and te. This arises, for example, from terminals like the Concept 
with more than one page of memory. If the terminal has only memory relative cursor addressing and not 
screen relative cursor addressing, a one screen-sized window must be fixed into the terminal for cursor 
addressing to work properly. 

If your terminal correctly generates underlined characters (with no special codes needed) even though it 
does not overstrike, then you should give the capability ul. If overstrikes are erasable with a blank, then 
this should be indicated by giving eo. 

Keypad 

If the terminal has a keypad that transmits codes when the keys are pressed, this information can be given. 
Note that it is not possible to handle terminals where the keypad only works in local (this applies, for exam¬ 
ple, to the unshifted HP 2621 keys). If the keypad can be set to transmit or not transmit, give these codes as 
ks and ke. Otherwise the keypad is assumed to always transmit. The codes sent by the left arrow, right 
arrow, up arrow, down arrow, and home keys can be given as kl, kr, ku, kd, and kh respectively. If there 
are function keys such as fO, fl, ..., f9, the codes they send can be given as kO, kl, ..., k9. If these keys 
have labels other than the default fO through f9, the labels can be given as 10, 11, ..., 19. If there are other 
keys that transmit the same code as the terminal expects for the corresponding function, such as clear 
screen, the termcap 2 letter codes can be given in the ko capability, for example, “:ko=cl,ll,sf,sb:”, which 
says that the terminal has clear, home down, scroll down, and scroll up keys that transmit the same thing as 
the cl, 11, sf, and sb entries. 

The ma entry is also used to indicate arrow keys on terminals which have single character arrow keys. It is 
obsolete but still in use in version 2 of vi, which must be run on some minicomputers due to memory limi¬ 
tations. This field is redundant with kl, kr, ku, kd, and kh. It consists of groups of two characters. In each 
group, the first character is what an arrow key sends, the second character is the corresponding vi com¬ 
mand. These commands are h for kl, j for kd, k for ku, 1 for kr, and H for kh. For example, the mime 
would be :ma=~Kj~Zk~XI: indicating arrow keys left CH), down CK), up ('Z), and right ('X). (There is no 
home key on the mime.) 

Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, then this can be given as pc. 

If tabs on the terminal require padding, or if the terminal uses a character other than "I to tab, then this can 
be given as ta. 
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Hazeltine terminals, which don’t allow characters to be printed should indicate hz. Datamedia termi¬ 
nals, which echo carriage-return linefeed for carriage return and then ignore a following linefeed should 
indicate nc. Early Concept terminals, which ignore a linefeed immediately after an am wrap, should indi¬ 
cate xn. If an erase-eol is required to get rid of standout (instead of merely writing on top of it), xs should 
be given. Teleray terminals, where tabs turn all characters moved over to blanks, should indicate xt. Other 
specific terminal problems may be corrected by adding more capabilities of the form xx 

Other capabilities include is, an initialization string for the terminal, and if, the name of a file containing 
long initialization strings. These strings are expected to properly clear and then set the tabs on the terminal, 
if the terminal has settable tabs. If both are given, is will be printed before if. This is useful where if is 
/usr/lib/tabset/std but is clears the tabs first. 

Similar Terminals 

If there are two very similar terminals, one can be defined as being just like the other with certain excep¬ 
tions. The string capability tc can be given with the name of the similar terminal. This capability must be 
last and the combined length of the two entries must not exceed 1024. Since termlib routines search the 
entry from left to right, and since the tc capability is replaced by the corresponding entry, the capabilities 
given at the left override the ones in the similar terminal. A capability can be cancelled with xx@ where xx 
is the capability. For example, the entry 

hn I 2621nl:ks@:ke@:tc=2621: 

defines a 2621nl that does not have the ks or ke capabilities, and hence does not turn on the function key 
labels when in visual mode. This is useful for different modes for a terminal, or for different user prefer¬ 
ences. 


FILES 

/etc/termcap file containing terminal descriptions 
SEE ALSO 

ex(l), termcap(3), vi(l) 

AUTHOR 

William Joy 

Mark Horton added underlining and keypad support 

BUGS 

Ex allows only 256 characters for string capabilities, and the routines in termcap(3) do not check for 
overflow of this buffer. The total length of a single entry (excluding only escaped newlines) may not 
exceed 1024. 

The ma, vs, and ve entries are specific to the vi program. 

Not all programs support all entries. There are entries that are not supported by any program. 

SUPPORT 

COMPONENT NAME: termcap 
APPROVAL AUTHORITY: Local 
STATUS: Provisional 
SUPPLIER: HOCC 

USER INTERFACE: Program Counseling Service 
SUPPORT LEVEL: Provisional 
COMMENTS: 
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NAME 

types - primitive system data types 

SYNOPSIS 

#include <sys/types h> 

DESCRIPTION 

The data types defined in the include file are used in UNIX System code; some data of these types are acces¬ 
sible to user code: 


typedef struct { int r[ 1 ] 

;}* 

typedef long 

daddr t; 

typedef char * 

caddr t; 

typedef unsigned int 

uint; 

typedef unsigned short 

ushort; 

typedef ushort 

ino t; 

typedef short 

cnt t; 

typedef long 

time t; 

typedef int 

label_t[10]; 

typedef short 

dev t; 

typedef long 

offt; 

typedef long 

paddr t; 

typedef long 

key t; 


physadr; 


The form daddr_t is used for disk addresses except in an i-node on disk, see /.v(4). Times are encoded in 
seconds since 00:00:00 GMT, January 1, 1970. The major and minor parts of a device code specify kind 
and unit number of a device and are installation-dependent. Offsets are measured in bytes from the begin¬ 
ning of a file. The labelj variables are used to save the processor state while another process is running. 


SEE ALSO 

fs(4). 


Page 1 



INTRO(6) 


INTRO(6) 


NAME 

intro - introduction to games 

DESCRIPTION 

This section describes the recreational and educational programs found in the directory /usr/games. The 
availability of these programs may vary from system to system. 
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NAME 

arithmetic - provide drill in number facts 
SYNOPSIS 

/usr/games/arithmetic [ +-x/ ] [ range ] 

DESCRIPTION 

Arithmetic types out simple arithmetic problems, and waits for an answer to be typed in. If the answer is 
correct, it types back “Right!”, and a new problem. If the answer is wrong, it replies “What?”, and waits 
for another answer. Every twenty problems, it publishes statistics on correctness and the time required to 
answer. 

To quit the program, type an interrupt (delete). 

The first optional argument determines the kind of problem to be generated; +, -, x, and / respectively cause 
addition, subtraction, multiplication, and division problems to be generated. One or more characters can be 
given; if more than one is given, the different types of problems will be mixed in random order; default is 

+-. 

Range is a decimal number; all addends, subtrahends, differences, multiplicands, divisors, and quotients 
will be less than or equal to the value of range. Default range is 10. 

At the start, all numbers less than or equal to range are equally likely to appear. If the respondent makes a 
mistake, the numbers in the problem which was missed become more likely to reappear. 

As a matter of educational philosophy, the program will not give correct answers, since the learner should, 
in principle, be able to calculate them. Thus the program is intended to provide drill for someone just past 
the first learning stage, not to teach number facts de novo. For almost all users, the relevant statistic should 
be time per problem, not percent correct. 
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NAME 

back - the game of backgammon 

SYNOPSIS 

/usr/games/back 

DESCRIPTION 

Back is a program which provides a partner for the game of backgammon. It is designed to play at three 
different levels of skill, one of which you must select. In addition to selecting the opponent’s level, you 
may also indicate that you would like to roll your own dice during your turns (for the superstitious players). 
You will also be given the opportunity to move first. The practice of each player rolling one die for the first 
move is not incorporated. 

The points are numbered 1-24, with 1 being white’s extreme inner table, 24 being brown's inner table, 0 
being the bar for removed white pieces and 25 the bar for brown. For details on how moves are expressed, 
type y when back asks “Instructions?” at the beginning of the game. When back first asks “Move?”, 
type ? to see a list of move options other than entering your numerical move. 

When the game is finished, back will ask you if you want the log. If you respond with y, back will attempt 
to append to or create a file back log in the current directory. 

FILES 

/usr/games/lib/backrules rules file 

/tmp/b* log temp file 

back.log log file 

BUGS 

The only level really worth playing is “expert”, and it only plays the forward game. 

Back will complain loudly if you attempt to make too many moves in a turn, but will become very silent if 
you make too few. 

Doubling is not implemented. 
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NAME 

bj - the game of black jack 

SYNOPSIS 

/usr/games/bj 

DESCRIPTION 

Bj is a serious attempt at simulating the dealer in the game of black jack (or twenty-one) as might be found 
in Reno. The following rules apply: 

The bet is $2 every hand. 

A player “natural” (blackjack) pays $3. A dealer natural loses $2. Both dealer and player naturals 
is a “push” (no money exchange). 

If the dealer has an ace up, the player is allowed to make an ‘ ‘insurance’ ’ bet against the chance of a 
dealer natural. If this bet is not taken, play resumes as normal. If the bet is taken, it is a side bet 
where the player wins $2 if the dealer has a natural and loses $1 if the dealer does not. 

If the player is dealt two cards of the same value, he is allowed to “double”. He is allowed to play 
two hands, each with one of these cards. (The bet is doubled also; $2 on each hand.) 

If a dealt hand has a total of ten or eleven, the player may “double down". He may double the bet 
($2 to $4) and receive exactly one more card on that hand. 

Under normal play, the player may “hit” (draw a card) as long as his total is not over twenty-one. If 
the player ‘ ‘busts’ ’ (goes over twenty-one), the dealer wins the bet. 

When the player “stands” (decides not to hit), the dealer hits until he attains a total of seventeen or 
more. If the dealer busts, the player wins the bet. 

If both player and dealer stand, the one with the largest total wins. A tie is a push. 

The machine deals and keeps score. The following questions will be asked at appropriate times. Each 
question is answered by y followed by a new-line for “yes”, or just new-line for “no”. 

? (means, “do you want a hit?”) 

Insurance? 

Double down? 

Every time the deck is shuffled, the dealer so states and the “action” (total bet) and “standing” (total won 
or lost) is printed. To exit, hit the interrupt key (DEL) and the action and standing will be printed. 
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NAME 

chess - the game of chess 

SYNOPSIS 

/usr/games/chess 

DESCRIPTION 

Chess is a computer program that plays class D chess. Moves may be given either in standard (descriptive) 
notation or in algebraic notation. The symbol + must be placed at the end of a line when the move on that 
line places the opponent’s king in check, o-o and o-o-o specify castling, king side or queen side, respec¬ 
tively. 

The user is prompted for a move or command by a *. To play black, type first at the onset of the game. To 
print a copy of the board in play, type a carriage return only. Each move is echoed in the appropriate nota¬ 
tion, followed by the program’s reply. Near the middle and end games, the program can take considerable 
time in computing its moves. 

A ? or help may be typed to get a help message that briefly describes the possible commands. 
DIAGNOSTICS 

The most cryptic diagnostic is “eh?” which means that the input was syntactically incorrect. 

BUGS 

Pawns may be promoted only to queens. 
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NAME 

craps - the game of craps 

SYNOPSIS 

/usr/games/craps 

DESCRIPTION 

Craps is a form of the game of craps that is played in Las Vegas. The program simulates the roller , while 
the user (the player ) places bets. The player may choose, at any time, to bet with the roller or with the 
House. A bet of a negative amount is taken as a bet with the House, any other bet is a bet with the roller. 

The player starts off with a ‘ ‘bankroll' ’ of $2,000. 

The program prompts with: 

bet? 


The bet can be all or part of the player’s bankroll. Any bet over the total bankroll is rejected and the pro¬ 
gram prompts with bet? until a proper bet is made. 

Once the bet is accepted, the roller throws the dice. The following rules apply (the player wins or loses 
depending on whether the bet is placed with the roller or with the House; the odds are even). The first roll 
is the roll immediately following a bet: 

1. On the first roll: 


7 or 11 

2, 3, or 12 

any other number 


wins for the roller; 
wins for the House; 

is the point , roll again (Rule 2 applies). 


2. On subsequent rolls: 
point 
7 

any other number 


roller wins; 
House wins; 
roll again. 


If a player loses the entire bankroll, the House will offer to lend the player an additional $2,000. The pro¬ 
gram will prompt: 


marker? 


A yes (or y) consummates the loan. Any other reply terminates the game. 

If a player owes the House money, the House reminds the player, before a bet is placed, how many markers 
are outstanding. 

If, at any time, the bankroll of a player who has outstanding markers exceeds $2,000, the House asks: 

Repay marker? 

A reply of yes (or y) indicates the player’s willingness to repay the loan. If only 1 marker is outstanding, it 
is immediately repaid. However, if more than 1 marker are outstanding, the House asks: 

How many? 

markers the player would like to repay. If an invalid number is entered (or just a carriage return), an appro¬ 
priate message is printed and the program will prompt with How many? until a valid number is entered. 

If a player accumulates 10 markers (a total of $20,000 borrowed from the House), the program informs the 
player of the situation and exits. 

Should the bankroll of a player who has outstanding markers exceed $50,000, the total amount of money 
borrowed will be automatically repaid to the House. 

Any player who accumulates $100,000 or more breaks the bank. The program then prompts: 

New game? 
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to give the House a chance to win back its money. 

Any reply other than yes is considered to be a no (except in the case of bet? or How many?). To exit, send 
an interrupt (break), DEL, or control-D. The program will indicate whether the player won, lost, or broke 
even. 

MISCELLANEOUS 

The random number generator for the die numbers uses the seconds from the time of day. Depending on 
system usage, these numbers, at times, may seem strange but occurrences of this type in a real dice situation 
are not uncommon. 
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NAME 

hangman - guess the word 
SYNOPSIS 

/usr/games/hangman [ arg ] 

DESCRIPTION 

Hangman chooses a word at least seven letters long from a dictionary. The user is to guess letters one at a 
time. 

The optional argument arg names an alternate dictionary. 

FILES 

/usr/lib/w2006 

BUGS 

Hyphenated compounds are run together. 
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NAME 

jotto - secret word game 

SYNOPSIS 

/usr/games/jotto [ -p ] 

DESCRIPTION 

Jotto is a word guessing game. You try to guess the computer’s secret word before it guesses yours. Clues 
are obtained by entering probe words. For example, if the computer’s secret word is “brown” and you 
probe with “stare”, it will reply “1” indicating that there is one letter in common between your probe and 
the secret word. Double letters count only once unless they appear in both words. For example, if the hid¬ 
den word is “igloo” and you probe with “broke”, the computer will reply “1”. But if you probe with 
“gloom”, the computer will respond “4”. All secret words and probe words should be non-proper English 
five-letter words. If the computer guesses your word exactly, please respond with “y”. It will then tell you 
what its secret word was. The -p flag instructs the computer to report its progress in guessing your word. 

BUGS 

The dictionary contains some unusual words and lacks some common ones. 
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NAME 

maze - generate a maze 

SYNOPSIS 

/usr/games/maze 

DESCRIPTION 

Maze asks a few questions and then prints a maze. 

BUGS 

Some mazes (especially small ones) have no solutions. 
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NAME 

moo - guessing game 

SYNOPSIS 

/usr/games/moo 

DESCRIPTION 

Moo is a guessing game imported from England. The computer picks a number consisting of four distinct 
decimal digits. The player guesses four distinct digits being scored on each guess. A “cow” is a correct 
digit in an incorrect position. A “bull” is a correct digit in a correct position. The game continues until the 
player guesses the number (a score of four bulls). 
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NAME 

quiz - test your knowledge 
SYNOPSIS 

/usr/games/quiz [ -i file ] [ -t ] [ category 1 category2 ] 

DESCRIPTION 

Quiz gives associative knowledge tests on various subjects. It asks items chosen from categoryl and 
expects answers from category2 , or vice versa. If no categories are specified, quiz gives instructions and 
lists the available categories. 

Quiz tells a correct answer whenever you type a bare new-line. At the end of input, upon interrupt, or when 
questions run out, quiz reports a score and terminates. 

The -t flag specifies “tutorial” mode, where missed questions are repeated later, and material is gradually 
introduced as you learn. 

The -i flag causes the named file to be substituted for the default index file. The lines of these files have the 
syntax: 

line = category new-line I category : line 
category = alternate I category I alternate 
alternate = empty I alternate primary 
primary = character | [ category ] I option 
option = { category } 

The first category on each line of an index file names an information file. The remaining categories specify 
the order and contents of the data in each line of the information file. Information files have the same syn¬ 
tax. Backslash \ is used as with sh{ 1) to quote syntactically significant characters or to insert transparent 
new-lines into a line. When either a question or its answer is empty, quiz will refrain from asking it. 

FILES 

/usr/games/lib/quiz/index 
/usr/games/lib/quiz/* 

BUGS 

The construct “a I ab” doesn’t work in an information file. Use “a{b}”. 
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NAME 

reversi - a game of dramatic reversals 

SYNOPSIS 

/usr/games/reversi [ [ -r ] file ] 

DESCRIPTION 

Reversi (also known as “friends”, “Chinese friends” and “Othello”) is played on an 8 by 8 board using 
two-sided tokens. Each player takes his turn by placing a token with his side up in an empty square. Dur¬ 
ing the first four turns, players may only place tokens in the four central squares of the board. Subse¬ 
quently, with each turn, a player must capture one or more of his opponent’s tokens. He does this by plac¬ 
ing one of his tokens such that it and another of his tokens embrace a solid line of his opponent’s horizon¬ 
tally, vertically or diagonally. Captured tokens are flipped over and thus can be re-captured. If a player 
cannot outflank his opponent he forfeits his turn. The play continues until the board is filled or until no 
more outflanking is possible. 

In this game, your tokens are asterisks (*) and the machine’s are at-signs (@). You move by typing in the 
row and column at which you want to place your token as two digits (1-8), optionally separated by blanks 
or tabs. You can also type in: 

c to continue the game after hitting break (this is only necessary if you interrupt the 

machine while it is deliberating), 

g n to start reversi playing against itself for the next n moves (or until the break key is hit), 

n to stop printing the board after each move, 

o to start it up again, 

p to print the board regardless, 

q to quit (without dishonor), 

s to print the score, and, as always, 

! to escape to the shell. Control-d gets you back. 

Reversi also recognizes several commands which are valid only at the start of the game, before any moves 
have been made. They are: 

f to let the machine go first. 

h n to ask for a handicap of from one to four corner squares. If you’re really good, you can 
give the machine a handicap by typing a negative number. 

1 n to set the amount of look-ahead used by the machine in searching for moves. Zero means 
none at all. Four is the default. Greater than six means you may fall asleep waiting for 
the machine to move. 

t n to tell reversi that you will only need n seconds to consider each move. If you fail to 
respond in the allotted time, you forfeit your turn. 

If reversi is given a file name as an argument, it will checkpoint the game, move by move, by dumping the 
board onto file. The -r option will cause reversi to restart the game from file and continue logging. 

DIAGNOSTICS 

“Illegal!” for an illegal move, and “Huh?” for a move that even the machine cannot understand. 
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NAME 

sky - obtain ephemerides 

SYNOPSIS 

/usr/games/sky [ -1 ] 

DESCRIPTION 

Sky predicts the apparent locations of the Sun, the Moon, the planets out to Saturn, stars of magnitude at 
least 2.5, and certain other celestial objects. Sky reads the standard input to obtain a GMT time typed on 
one line with blanks separating year, month number, day, hour, and minute; if the year is missing the cur¬ 
rent year is used. If a blank line is typed the current time is used. The program prints the azimuth, eleva¬ 
tion, and magnitude of objects which are above the horizon at the ephemeris location of Murray Hill at the 
indicated time. The -1 flag causes it to ask for another location. 

Placing a “1” input after the minute entry causes the program to print out the Greenwich Sidereal Time at 
the indicated moment and to print for each body its topographic right ascension and declination as well as 
its azimuth and elevation. Also, instead of the magnitude, the semidiameter of the body, in seconds of arc, 
is reported. 

A “2” after the minute entry makes the coordinate system geocentric. 

The effects of atmospheric extinction on magnitudes are not included; the brightest magnitudes of variable 
stars are marked with *. 

For all bodies, the program takes into account precession and nutation of the equinox, annual (but not diur¬ 
nal) aberration, diurnal parallax, and the proper motion of stars. In no case is refraction included. 

The program takes into account perturbations of the Earth due to the Moon, Venus, Mars, and lupiter. The 
expected accuracies are: for the Sun and other stellar bodies a few tenths of seconds of arc; for the Moon 
(on which particular care is lavished) likewise a few tenths of seconds. For the Sun, Moon and stars the 
accuracy is sufficient to predict the circumstances of eclipses and occultations to within a few seconds of 
time. The planets may be off by several minutes of arc. 

There are lots of special options not described here, which do things like substituting named star catalogs, 
smoothing nutation and aberration to aid generation of mean places of stars, and making conventional 
adjustments to the Moon to improve eclipse predictions. 

For the most accurate use of the program it is necessary to know that it actually runs in Ephemeris time. 

SEE ALSO 

American Ephemeris and Nautical Almanac , for the appropriate years; also, the Explanatory Supplement to 
the American Ephemeris and Nautical Almanac. 
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NAME 

ttt, cubic - tic-tac-toe 

SYNOPSIS 

/usr/games/ttt 

/usr/games/cubic 

DESCRIPTION 

Ttt is the X and O game popular in the first grade. This is a learning program that never makes the same 
mistake twice. 

Although it learns, it learns slowly. It must lose nearly 80 games to completely know the game. 

Cubic plays three-dimensional tic-tac-toe on a 4x4x4 board. Moves are specified as a sequence of three 
coordinate numbers in the range 1-4. 

FILES 

/usr/games/ttt.k learning file 

BUGS 

Cubic does not yet work on VAX. 
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NAME 

wump - the game of hunt-the-wumpus 

SYNOPSIS 

/usr/games/wump 

DESCRIPTION 

Wump plays the game of “Hunt the Wumpus.” A Wumpus is a creature that lives in a cave with several 
rooms connected by tunnels. You wander among the rooms, trying to shoot the Wumpus with an arrow, 
meanwhile avoiding being eaten by the Wumpus and falling into Bottomless Pits. There are also Super 
Bats which are likely to pick you up and drop you in some random room. 

The program asks various questions which you answer one per line; it will give a more detailed description 
if you want. 

This program is based on one described in People’s Computer Company, 2, 2 (November 1973). 

BUGS 

It will never replace Adventure. 
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